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

# 사용자

## 개요

사용자는 팀에 속하며 자신의 권한과 역할에 따라 Epsilon Retail Media 시스템 내에서 다양한 작업을 수행할 수 있는 개인입니다.

### 사용자 ID란 무엇인가요?

사용자 ID는 시스템의 각 사용자에 대한 고유 식별자입니다. Epsilon Retail Media 사용자 세부 정보 업데이트, 권한 수정 또는 사용자 정보 조회와 같이 특정 사용자를 식별하고 관리하기 위해 API 요청 시 필수적으로 요구됩니다.

### 사용자 ID 찾기

사용자 API를 사용하려면 사용자 ID가 필요합니다. 이는 API 요청에서 특정 사용자를 식별합니다. 다음 방법으로 찾을 수 있습니다.

1. Citrus Client에 로그인합니다.
2. 프로필 드롭다운을 클릭하고 **사용자 프로필**을 선택합니다.
3. 사용자 ID는 사용자 프로필 섹션에 표시됩니다.

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

### 사용자 요소

각 사용자는 다음 주요 요소를 포함합니다.

| 요소     | 설명                             |
| ------ | ------------------------------ |
| 사용자 ID | 사용자의 고유 식별자입니다.                |
| 이메일    | 로그인 및 알림에 사용되는 사용자의 이메일 주소입니다. |
| 이름     | 사용자의 이름입니다.                    |
| 성      | 사용자의 성입니다.                     |
| 로고 ID  | 사용자 프로필 이미지의 고유 식별자입니다.        |
| 팀 소속   | 사용자가 속한 팀 목록입니다.               |
| 권한     | 팀 내 사용자의 액세스 수준 및 권한입니다.       |
| 초대 상태  | 대기 중인 팀 초대 상태입니다.              |

### 사용자 API 필드 정의

다음은 API 요청 및 응답에 일반적으로 사용되는 주요 사용자 필드입니다.

| 필드명                | 설명                                                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| id                 | 사용자의 고유 식별자입니다.                                                                                                                             |
| email              | 사용자의 이메일 ID입니다.                                                                                                                             |
| namespace          | 사용자가 속한 네임스페이스입니다.                                                                                                                          |
| firstName          | 사용자의 이름입니다.                                                                                                                                 |
| lastName           | 사용자의 성입니다.                                                                                                                                  |
| logoUrl            | 사용자의 프로필 사진 또는 로고 URL입니다. 다음을 사용하여 logoUrl을 조회할 수 있습니다. [파일 URL 조회](/retail-media-interface/partner/ko/team-user-api/user-1/getfileurl.md). |
| teamIds            | 사용자의 팀 ID 목록입니다.                                                                                                                            |
| receivedInvitation | 대기 중인 초대 세부 정보입니다.                                                                                                                          |
| inviteTeam         | 초대 페이로드의 루트 개체입니다.                                                                                                                          |
| managerTeamId      | 액세스를 관리하고 초대를 보내는 리테일러 팀의 고유 ID입니다. 예: manager-team-123.                                                                                    |
| roleIds            | 사용자의 권한 문자열 배열입니다.                                                                                                                          |
| teamId             | 사용자 초대용 팀 ID입니다.                                                                                                                            |
| retailerTeamId     | 리테일러가 관리하는 그룹의 고유 ID입니다.                                                                                                                    |
| offset             | 결과를 가져오기 전에 건너뛸 레코드 수입니다.                                                                                                                   |

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

| 엔드포인트                                                                                      | 설명                                                                                                                                                       |
| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Invite a user to the team](/retail-media-interface/partner/ko/team-user-api/user-1.md)    | 지정된 팀에 가입하기 위한 이메일 초대장을 보냅니다. 팀 ID 및 사용자 이메일 주소가 필요합니다.                                                                                                  |
| [Retrieve current user detail](/retail-media-interface/partner/ko/team-user-api/user-1.md) | <p>다음 정보를 포함하여 로그인한 사용자의 프로필 정보를 조회합니다.<br>-사용자 ID, 이메일, 이름, 성 및<br>-보낸 사람 세부정보가 포함된 보류 중인 팀 초대.<br>이 엔드포인트를 사용하여 현재 로그인한 사용자의 세부정보를 확인합니다.</p>          |
| [Retrieve user details](/retail-media-interface/partner/ko/team-user-api/user-1.md)        | <p>팀 내 다른 사용자 또는 사용자 ID별 특정 사용자에 대한 정보를 조회합니다.<br>네임스페이스 내에 적절한 액세스 권한(리테일러 또는 관리자)이 필요하며 사용자가 팀의 일원이어야 합니다. 이 엔드포인트는 팀 수준의 사용자 관리에 사용됩니다.</p>           |
| [Update current user detail](/retail-media-interface/partner/ko/team-user-api/user-1.md)   | 로그인한 사용자의 이름, 성 및 로고 파일 ID를 수정합니다. 이 엔드포인트는 다른 사용자의 세부정보 업데이트를 지원하지 않습니다.                                                                                |
| [Remove a user](/retail-media-interface/partner/ko/team-user-api/user-1.md)                | 팀에서 사용자를 제거합니다(적절한 권한 필요).                                                                                                                               |
| [Modify user permission](/retail-media-interface/partner/ko/team-user-api/user-1.md)       | <p>사용자 ID 및 팀 ID별로 사용자 권한을 업데이트합니다.<br>권한 유형\*\*:<br>-리테일러(전체 또는 보고서 보기)<br>-공급업체(전체 또는 보고서 보기).<br><strong>참고</strong>: 리테일러 및 공급업체 역할은 겸임할 수 없습니다.</p> |
| [Upload a file](/retail-media-interface/partner/ko/team-user-api/user-1.md)                | 사용자 프로필 및 팀용 로고를 업로드합니다.                                                                                                                                 |
| [Retrieve file URL](/retail-media-interface/partner/ko/team-user-api/user-1.md)            | <p>파일 ID를 사용하여 업로드된 파일의 임시 다운로드 URL을 생성합니다.<br><strong>참고</strong>: URL은 3600초 동안만 유효합니다.</p>                                                            |

일반적인 질문과 문제 해결 팁은 다음을 참조하세요. [자주 묻는 질문](/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/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.