> 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/user-1.md).

# ユーザー

## 概要

ユーザーとはチームに所属する個人であり、権限や役割に基づいて Epsilon Retail Media システム内でさまざまなアクションを実行できます。

### ユーザー ID とは？

ユーザー ID は、システム内の各ユーザーに対する一意の識別子です。 Epsilon Retail Media ユーザー詳細の更新、権限の変更、ユーザー情報の取得など、特定のユーザーを識別および管理するための API リクエストで必要となります。

### ユーザー ID の確認方法

ユーザー API を使用するには、ユーザー ID が必要です。これにより API リクエスト内の特定のユーザーが識別されます。確認方法は以下の通りです：

1. Citrus クライアントにログインします。
2. プロフィール ドロップダウンをクリックし、**ユーザー プロフィール**を選択します。
3. ユーザー ID はユーザー プロフィール セクションに表示されます。

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

### ユーザーの要素

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

| 要素          | 説明                       |
| ----------- | ------------------------ |
| ユーザー ID     | ユーザーの一意の識別子。             |
| メールアドレス     | ログインおよび通知用のユーザーのメールアドレス。 |
| 名           | ユーザーの名。                  |
| 姓           | ユーザーの姓。                  |
| ロゴ ID       | ユーザーのプロフィール画像の一意の識別子。    |
| チーム メンバーシップ | ユーザーが所属するチームのリスト。        |
| 権限          | チーム内でのユーザーのアクセスレベルと権限。   |
| 招待ステータス     | 保留中のチーム招待のステータス。         |

### ユーザー API フィールド定義

以下は、API リクエストおよびレスポンスでよく使用される主要なユーザー フィールドです：

| フィールド名             | 説明                                                                                                                                 |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| id                 | ユーザーの一意の識別子。                                                                                                                       |
| email              | ユーザーのメール ID。                                                                                                                       |
| namespace          | ユーザーが所属するネームスペース。                                                                                                                  |
| firstName          | ユーザーの名。                                                                                                                            |
| lastName           | ユーザーの姓。                                                                                                                            |
| logoUrl            | ユーザーのプロフィール画像またはロゴへの URL。logoUrl を使用して取得できます [ファイルのURLを取得](/retail-media-interface/partner/ja/team-user-api/user-1/getfileurl.md). |
| teamIds            | ユーザーのチーム ID のリスト。                                                                                                                  |
| receivedInvitation | 保留中の招待の詳細。                                                                                                                         |
| inviteTeam         | 招待ペイロードのルート オブジェクト。                                                                                                                |
| managerTeamId      | アクセスを管理し、招待を送信するリテール チームの一意の ID。例: manager-team-123。                                                                               |
| roleIds            | ユーザーの権限文字列の配列。                                                                                                                     |
| teamId             | ユーザー招待先のチームの ID。                                                                                                                   |
| retailerTeamId     | リテール管理グループの一意の ID。                                                                                                                 |
| offset             | 結果を取得する前にスキップするレコード数。                                                                                                              |

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

| エンドポイント                                                                     | 説明                                                                                                                                                           |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [チームにユーザーを招待する](/retail-media-interface/partner/ja/team-user-api/user-1.md) | 指定したチームに参加するためのメール招待を送信します。チーム ID とユーザーのメールアドレスが必要です。                                                                                                        |
| [現在のユーザーの詳細を取得](/retail-media-interface/partner/ja/team-user-api/user-1.md) | <p>サインインしているユーザーのプロファイル情報を取得します。これには以下が含まれます:<br>-ユーザーID、メールアドレス、名、姓、および<br>-送信者の詳細を含む保留中のチームへの招待。<br>現在サインインしているユーザーの詳細を表示するには、このエンドポイントを使用します。</p>         |
| [ユーザーの詳細を取得](/retail-media-interface/partner/ja/team-user-api/user-1.md)    | <p>チーム内の他のユーザーに関する情報、またはユーザーIDで指定された特定ユーザーの情報を取得します。<br>ネームスペース内の適切なアクセス権限（リテールまたは管理者）が必要であり、ユーザーはチームの一員である必要があります。このエンドポイントは、チームレベルのユーザー管理に使用されます。</p>      |
| [現在のユーザーの詳細を更新](/retail-media-interface/partner/ja/team-user-api/user-1.md) | サインインしているユーザーの名、姓、およびロゴファイルIDを変更します。このエンドポイントは、他のユーザーの詳細の更新をサポートしていません。                                                                                      |
| [ユーザーを削除](/retail-media-interface/partner/ja/team-user-api/user-1.md)       | チームからユーザーを削除します（適切な権限が必要です）。                                                                                                                                 |
| [ユーザー権限を修正](/retail-media-interface/partner/ja/team-user-api/user-1.md)     | <p>ユーザーIDとチームIDを指定してユーザーの権限を更新します。<br>権限タイプ\*\*:<br>-リテール（フルまたはレポート表示）<br>-サプライヤー（フルまたはレポート表示）。<br><strong>注</strong>: リテールロールとサプライヤーロールを組み合わせることはできません。</p> |
| [ファイルをアップロード](/retail-media-interface/partner/ja/team-user-api/user-1.md)   | ユーザープロファイルおよびチームのロゴをアップロードします。                                                                                                                               |
| [ファイルのURLを取得](/retail-media-interface/partner/ja/team-user-api/user-1.md)   | <p>ファイルIDを使用して、アップロードされたファイルの一時的なダウンロードURLを生成します。<br><strong>注</strong>: URLは3600秒間のみ有効です。</p>                                                               |

よくある質問とトラブルシューティングのヒントについては、次を参照してください: [よくある質問](/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/user-1.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.