> 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/ja/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/q7nUG8l07KQKnuAHT6io" alt="" width="100%"><figcaption></figcaption></figure>

### チームの要素

各チームには以下の主要要素が含まれます：

| フィールド名       | 説明                                                |
| ------------ | ------------------------------------------------- |
| Team ID      | チームの一意の識別子。                                       |
| チーム名         | チームの名前。                                           |
| 会社名          | チームに関連付けられている会社の名前。                               |
| 会社のウェブサイト    | 会社の公式ウェブサイトURL。                                   |
| 電話番号         | 会社の連絡先電話番号。                                       |
| 会社の住所        | 会社の所在地住所。                                         |
| 郵便番号         | 会社住所の郵便番号。                                        |
| 事業ID         | ビジネス上または法律上の目的で使用される識別子。                          |
| ad financier | EUのデジタルサービス法（DSA）などの地域法規を遵守するために必要な、広告に資金を提供する主体。 |

### Team APIのフィールド定義

| フィールド名                 | 説明                                                           |
| ---------------------- | ------------------------------------------------------------ |
| id                     | チームの一意のID。                                                   |
| name                   | チームの名前。                                                      |
| namespaceId            | ネームスペースの一意の識別子。                                              |
| companyName            | チームが所属する会社の名前。                                               |
| companyWebsite         | 会社のウェブサイトのURL。                                               |
| companyPhone           | レガシーフィールド。会社の電話番号。                                           |
| companyAddress         | 会社の所在地のアドレスオブジェクト。                                           |
| userIds                | チームに所属するユーザーの一意の識別子。                                         |
| reviewerEmail          | キャンペーンの審査が必要な場合に通知するメールアドレス。Primary Retailerチームにのみ適用されます。    |
| sellerId               | リテール企業から提供される一意のサプライヤー/マーチャントID。リテール企業から提供されたIDと一致する必要があります。 |
| notificationRecipients | キャンペーン通知の受信者。                                                |

### 利用可能なエンドポイント

| エンドポイント                                                                      | 説明                                                                                                                                                                                                                |
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [チームを作成する](/retail-media-interface/partner/ja/team-user-api/team.md)         | <p>新しいチームを作成します。チームは広告主、広告管理プラットフォーム、マーケットプレイスベンダーなどのサプライヤーを表します。<br><br>権限\*\*：<br>リテール企業：サプライヤーまたは広告主に代わってチームを作成できます（設定が必要です）。仕様上、リテール企業がリテール企業チームを作成することはできません。<br>サプライヤー：チームを作成できます（リテール企業によって許可されている場合）。</p> |
| [チームを更新](/retail-media-interface/partner/ja/team-user-api/team.md)           | <p>名前、会社情報、電話番号、ウェブサイトのURL、住所などのチームの詳細を更新します。<br><strong>注</strong>：このエンドポイントは設定に依存します。このAPIを使用するには、環境で関連する機能フラグまたは設定が有効になっていることを確認してください。</p>                                                                    |
| [すべてのチームを一覧表示](/retail-media-interface/partner/ja/team-user-api/team.md)     | パラメータを使用してチームを取得します： `name`, `namespace_id`, `seller_id`。ナビゲーションには `page_token` を使用し、ページごとの結果を制御するには`page_size` を使用します。                                                                                           |
| [指定されたIDのチームを取得する](/retail-media-interface/partner/ja/team-user-api/team.md) | メンバーを含む特定チームの詳細情報を取得します。                                                                                                                                                                                          |
| [招待トークンでチームに参加](/retail-media-interface/partner/ja/team-user-api/team.md)    | 有効な招待トークンを使用して、ユーザーがチームに参加できるようにします。                                                                                                                                                                              |

よくある質問とトラブルシューティングのヒントについては、以下を参照してください。 [よくある質問](/retail-media-interface/partner/ja/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/ja/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.