> 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/ko/team-user-api/team.md).

# 팀

## 개요

Teams API를 사용하면 리테일러, 광고주 및 공급업체가 API 엔드포인트를 통해 프로그래밍 방식으로 팀과 사용자를 관리할 수 있습니다.

### 타겟 오디언스

* 리테일러: 공급업체 팀을 관리하고 광고 파트너와 협업합니다.
* 광고주: 캠페인 협업을 위한 팀을 생성하고 관리합니다.
* 개발자: 애플리케이션에 팀 관리를 통합합니다.
* 광고 관리 플랫폼: 팀 생성 및 관리 워크플로를 지원합니다.

### 팀 관리

다음 Epsilon Retail Media 시스템에서 팀은 공급업체(광고주) 또는 리테일러를 나타냅니다. 공급업체 팀은 캠페인을 생성하고, 리테일러 팀은 이를 검토하고 관리합니다. 사용자는 여러 팀에 속할 수 있으며, 각 팀은 자체 사용자, 캠페인 및 지갑 세트를 가집니다.

#### Team ID란 무엇인가요?

Team ID는 Epsilon Retail Media 시스템의 각 팀에 대한 고유 식별자입니다. 광고 생성, 사용자 관리 또는 팀 수준 캠페인 리포팅 조회와 같은 작업을 올바른 리테일러 또는 공급업체 팀과 연결하려면 API 요청에 이 값이 필요합니다.

#### Team ID 찾기

Teams API를 사용하려면 Team ID가 필요합니다. 이는 API 요청에서 리테일러 또는 공급업체 팀을 식별합니다. 다음 방법으로 찾을 수 있습니다.

1. Citrus Client에 로그인합니다.
2. 프로필 드롭다운을 클릭하고 **Team Settings**를 선택합니다.
3. Team ID는 페이지 상단에 표시됩니다.

<figure><img src="/files/kd3tJfuG0zaZbHvLhvFS" alt="" width="100%"><figcaption></figcaption></figure>

### 팀 구성 요소

각 팀에는 다음과 같은 주요 구성 요소가 포함됩니다.

| 필드 이름           | 설명                                                          |
| --------------- | ----------------------------------------------------------- |
| Team ID         | 팀의 고유 식별자입니다.                                               |
| Team name       | 팀의 이름입니다.                                                   |
| Company name    | 팀과 관련된 회사의 이름입니다.                                           |
| Company website | 회사의 공식 웹사이트 URL입니다.                                         |
| Phone number    | 회사의 연락처 전화번호입니다.                                            |
| Company address | 회사의 실제 주소입니다.                                               |
| Postcode        | 회사 주소의 우편번호입니다.                                             |
| Business ID     | 비즈니스 또는 법적 목적으로 사용되는 식별자입니다.                                |
| ad financier    | EU의 디지털 서비스 법(DSA)과 같은 지역 법률 준수를 위해 필요한, 광고 자금을 지원하는 주체입니다. |

### 팀 API 필드 정의

| 필드 이름                  | 설명                                                   |
| ---------------------- | ---------------------------------------------------- |
| id                     | 팀의 고유 ID입니다.                                         |
| name                   | 팀의 이름입니다.                                            |
| namespaceId            | 네임스페이스의 고유 식별자입니다.                                   |
| companyName            | 팀이 속한 회사의 이름입니다.                                     |
| companyWebsite         | 회사 웹사이트의 URL입니다.                                     |
| companyPhone           | 레거시 필드입니다. 회사의 전화번호입니다.                              |
| companyAddress         | 회사 위치의 주소 객체입니다.                                     |
| userIds                | 팀에 속한 사용자의 고유 식별자입니다.                                |
| reviewerEmail          | 캠페인 검토가 필요할 때 알림을 보낼 이메일입니다. 주 리테일러 팀에만 적용됩니다.       |
| sellerId               | 리테일러가 제공한 고유 공급업체/판매자 ID입니다. 리테일러가 제공한 ID와 일치해야 합니다. |
| notificationRecipients | 캠페인 알림을 받을 수신자입니다.                                   |

### 사용 가능한 엔드포인트

| 엔드포인트                                                                                         | 설명                                                                                                                                                                                                      |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Create team](/retail-media-interface/partner/ko/team-user-api/team.md)                       | <p>새 팀을 생성합니다. 팀은 광고주, 광고 관리 플랫폼 또는 마켓플레이스 판매자와 같은 공급업체를 나타냅니다.<br><br>권한\*\*:<br>리테일러: 공급업체 또는 광고주를 대신하여 팀을 생성할 수 있습니다(설정 필요). 구조상 리테일러는 리테일러 팀을 생성할 수 없습니다.<br>공급업체: 팀을 생성할 수 있습니다(리테일러가 허용한 경우).</p> |
| [Update a team](/retail-media-interface/partner/ko/team-user-api/team.md)                     | <p>이름, 회사 정보, 전화번호, 웹사이트 URL 및 주소를 포함한 팀 세부정보를 업데이트합니다.<br><strong>참고</strong>: 이 엔드포인트는 설정에 따라 변경될 수 있습니다. 이 API를 사용하려면 환경에서 관련 기능 플래그 또는 설정이 활성화되어 있는지 확인하세요.</p>                                     |
| [Lists all teams](/retail-media-interface/partner/ko/team-user-api/team.md)                   | 매개변수를 사용하여 팀을 조회합니다: `name`, `namespace_id`, `seller_id`. 탐색에는 `page_token` 을(를) 사용하고 페이지당 결과를 제어하려면`page_size` 을(를) 사용합니다.                                                                             |
| [Get team for specified ID](/retail-media-interface/partner/ko/team-user-api/team.md)         | 구성원을 포함하여 특정 팀에 대한 상세 정보를 조회합니다.                                                                                                                                                                        |
| [Join a team with invitation token](/retail-media-interface/partner/ko/team-user-api/team.md) | 사용자가 유효한 초대 토큰을 사용하여 팀에 가입할 수 있도록 허용합니다.                                                                                                                                                                |

자주 묻는 질문과 문제 해결 팁은 다음을 참조하세요. [자주 묻는 질문](/retail-media-interface/partner/ko/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/ko/team-user-api/team.md?ask=<question>&goal=<endgoal>
```

`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.