> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/pt-br/team-user-api/team.md).
# Equipe
## Visão geral
A API de Teams permite que varejistas, anunciantes e fornecedores gerenciem equipes e usuários de forma programática por meio de endpoints de API.
### Público-alvo
* Varejistas: Gerenciem equipes de fornecedores e colaborem com parceiros de publicidade.
* Anunciantes: Crie e gerencie equipes para colaboração em campanhas.
* Desenvolvedores: Integre o gerenciamento de equipes em aplicativos.
* Plataforma de gerenciamento de anúncios: Facilite os fluxos de trabalho de criação e gerenciamento de equipes.
### Gerenciamento de equipes
No Epsilon Retail Media sistema, as equipes representam fornecedores (anunciantes) ou varejistas. As equipes de fornecedores criam campanhas, enquanto as equipes de varejistas as revisam e gerenciam. Os usuários podem pertencer a várias equipes, cada uma com seu próprio conjunto de usuários, campanhas e carteiras.
#### O que é um Team ID?
Um Team ID é um identificador exclusivo para cada equipe no Epsilon Retail Media sistema. Ele é obrigatório em solicitações de API para associar ações à equipe de varejista ou fornecedor correta, como gerar anúncios, gerenciar usuários ou recuperar relatórios de campanha em nível de equipe.
#### Localizando seu Team ID
Para usar a API de Teams, você precisará do seu Team ID. Ele identifica a equipe do varejista ou fornecedor nas solicitações da API. Você pode encontrá-lo ao:
1. Faça login no seu Citrus Client.
2. Clique no menu suspenso do perfil e selecione **Team Settings**.
3. O Team ID é exibido no topo da página.
### Elementos da equipe
Cada equipe inclui os seguintes elementos principais:
| Nome do campo | Descrição |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Team ID | Um identificador exclusivo para a equipe. |
| Team name | O nome da equipe. |
| Company name | O nome da empresa associada à equipe. |
| Company website | O URL do site oficial da empresa. |
| Phone number | O número de telefone de contato da empresa. |
| Company address | O endereço físico da empresa. |
| Postcode | O código postal do endereço da empresa. |
| Business ID | Um identificador usado para fins comerciais ou legais. |
| ad financier | Entidade que financia o anúncio, necessária para conformidade com leis regionais, como a Lei de Serviços Digitais (DSA) da UE. |
### Definições de campos da API de Teams
| Nome do campo | Descrição |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------- |
| id | O ID exclusivo da equipe. |
| name | O nome da equipe. |
| namespaceId | O identificador exclusivo do namespace. |
| companyName | O nome da empresa à qual a equipe pertence. |
| companyWebsite | O URL do site da empresa. |
| companyPhone | Campo legado. O número de telefone da empresa. |
| companyAddress | O objeto de endereço para a localização da empresa. |
| userIds | Identificadores exclusivos de usuários pertencentes à equipe. |
| reviewerEmail | E-mail para notificar quando uma campanha precisa de revisão. Aplicável apenas à equipe do varejista principal. |
| sellerId | ID exclusivo do fornecedor/comerciante fornecido por um varejista. Deve corresponder ao ID fornecido pelo varejista. |
| notificationRecipients | Destinatários de notificações da campanha. |
### Endpoints disponíveis
| Endpoint | Descrição |
| ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Create team](/retail-media-interface/partner/pt-br/team-user-api/team.md) |
Cria uma nova equipe. Uma equipe representa um fornecedor, como anunciante, plataforma de gestão de anúncios ou vendedor de marketplace.
Permissões\*\*: Varejistas: podem criar equipes em nome de fornecedores ou anunciantes (requer configuração). Por padrão, os varejistas não podem criar equipes de varejistas. Fornecedores: podem criar equipes (se permitido pelos varejistas).
|
| [Update a team](/retail-media-interface/partner/pt-br/team-user-api/team.md) |
Atualiza os detalhes da equipe, incluindo nome, informações da empresa, número de telefone, URL do site e endereço. Nota: Este endpoint está sujeito à configuração. Certifique-se de que a sinalização de recurso ou configuração relevante esteja habilitada em seu ambiente para usar esta API.
|
| [Lists all teams](/retail-media-interface/partner/pt-br/team-user-api/team.md) | Recupera equipes usando parâmetros: `name`, `namespace_id`, `seller_id`. Use `page_token` para navegação e`page_size` para controlar os resultados por página. |
| [Get team for specified ID](/retail-media-interface/partner/pt-br/team-user-api/team.md) | Recupera informações detalhadas sobre uma equipe específica, incluindo seus membros. |
| [Join a team with invitation token](/retail-media-interface/partner/pt-br/team-user-api/team.md) | Permite que os usuários entrem em uma equipe usando um token de convite válido. |
Para perguntas frequentes e dicas de solução de problemas, consulte [Perguntas frequentes](/retail-media-interface/partner/pt-br/partner-api-overview/frequently-asked-questions.md#team-and-user).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/partner/pt-br/team-user-api/team.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.