REST Resource: users

리소스: User

Display & Video 360의 단일 사용자

JSON 표현 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
입력란
name

string

출력 전용. 사용자의 리소스 이름입니다.
userId

string (int64 format)

출력 전용. 사용자의 고유 ID입니다. 시스템에서 할당합니다.
email

string

필수 항목입니다. 변경할 수 없습니다. 사용자 식별에 사용되는 이메일 주소입니다.
displayName

string

필수 항목입니다. 사용자의 표시 이름입니다.

UTF-8 형식으로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다.
assignedUserRoles[]

object (AssignedUserRole)

할당된 사용자 역할입니다.

users.create에서 필수입니다. users.patch에만 출력됩니다. users.bulkEditAssignedUserRoles을(를) 통해서만 업데이트할 수 있습니다.
lastLoginTime

string (Timestamp format)

출력 전용. 사용자가 DV360 UI에 마지막으로 로그인한 시점의 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

AssignedUserRole

할당된 단일 사용자 역할로, 지정된 파트너 또는 광고주와 사용자의 승인된 상호작용을 정의합니다.

JSON 표현 
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // Union field entity_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field entity_id.
}
입력란
assignedUserRoleId

string

출력 전용. 할당된 사용자 역할의 ID입니다.
userRole

enum (UserRole)

필수 항목입니다. 항목의 사용자에게 할당할 사용자 역할입니다.

통합 필드 entity_id. 필수 항목입니다.

할당된 사용자 역할이 적용되는 항목의 ID입니다. entity_id는 다음 중 하나여야 합니다.
partnerId

string (int64 format)

할당된 사용자 역할이 적용되는 파트너의 ID입니다.
advertiserId

string (int64 format)

할당 사용자 역할이 적용되는 광고주의 ID입니다.

UserRole

가능한 사용자 역할입니다.

열거형
USER_ROLE_UNSPECIFIED 이 버전에서 사용자 역할이 지정되지 않았거나 알 수 없는 경우의 기본값입니다.
ADMIN 사용자는 항목의 캠페인, 광고 소재, 게재 신청서, 광고 항목 및 보고서를 관리할 수 있습니다. 결제 정보를 확인 및 수정하고, 사용자를 만들거나 수정하고, 교환을 사용 설정 또는 사용 중지할 수 있습니다. 이 역할은 파트너 법인에만 할당할 수 있습니다.
ADMIN_PARTNER_CLIENT 사용자는 항목의 캠페인, 광고 소재, 게재 신청서, 광고 항목 및 보고서를 관리할 수 있습니다. 다른 ADMIN_PARTNER_CLIENT 사용자를 생성 및 수정하고 결제 정보를 볼 수 있습니다. 수익 모델, 마크업 또는 기타 리셀러에 해당하는 민감한 필드는 볼 수 없습니다. 이 역할은 파트너 법인에만 할당할 수 있습니다.
STANDARD 사용자는 항목의 캠페인, 광고 소재, 게재 신청서, 광고 항목 및 보고서를 관리할 수 있습니다. 사용자를 생성 및 수정하거나 결제 정보를 볼 수는 없습니다.
STANDARD_PLANNER 사용자는 모든 비용 데이터를 비롯하여 항목의 모든 캠페인, 광고 소재, 게재 신청서, 광고 항목 및 보고서를 볼 수 있습니다. 계획 및 인벤토리를 포함하여 계획 관련 기능을 만들고 수정할 수 있습니다.
STANDARD_PLANNER_LIMITED 사용자는 항목의 모든 캠페인, 광고 소재, 게재 신청서, 광고 항목 및 보고서를 볼 수 있습니다. 계획 및 인벤토리를 포함하여 계획 관련 기능을 만들거나 수정할 수 있습니다. 비용 데이터에 액세스할 수 없으며 거래를 시작, 수락, 협상할 수 없습니다.
STANDARD_PARTNER_CLIENT 사용자는 항목의 캠페인, 광고 소재, 게재 신청서, 광고 항목 및 보고서를 관리할 수 있습니다. 다른 사용자를 생성 또는 수정하거나 결제 정보를 볼 수 없습니다. 수익 모델, 마크업 또는 기타 리셀러에 해당하는 민감한 필드는 볼 수 없습니다. 이 역할은 광고주 항목에만 할당할 수 있습니다.
READ_ONLY 사용자는 항목에 대한 보고서를 작성하고 데이터를 볼 수만 있습니다.
REPORTING_ONLY 사용자는 보고서를 만들고 관리하는 것만 할 수 있습니다.
LIMITED_REPORTING_ONLY 사용자는 일반, 잠재고객 실적, 교차 파트너, 키워드, 주문 ID, 카테고리 및 제3자 데이터 제공업체와 같은 고객 안전 보고서만 만들고 관리할 수 있습니다.
CREATIVE 사용자가 공동작업에 필요한 미디어 계획 정보는 볼 수 있지만 비용 관련 데이터나 마켓플레이스는 볼 수 없습니다.
CREATIVE_ADMIN 사용자가 공동작업에 필요한 미디어 계획 정보는 볼 수 있지만 비용 관련 데이터나 마켓플레이스는 볼 수 없습니다. 또한 항목에 다른 광고 소재 관리자나 광고 소재 사용자를 추가할 수도 있습니다.

방법

bulkEditAssignedUserRoles

 사용자의 사용자 역할을 일괄 수정합니다.

create

 새 사용자를 만듭니다.

delete

 사용자를 삭제합니다.

get

 사용자를 가져옵니다.

list

 현재 사용자가 액세스할 수 있는 사용자를 나열합니다.

patch

 기존 사용자를 업데이트합니다.