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

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

최대 크기가 240바이트인 UTF-8로 인코딩되어야 합니다.
assignedUserRoles[]

object (AssignedUserRole)

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

users.create에서 요구됨. users.patch의 출력 전용입니다. users.bulkEditAssignedUserRoles를 통해서만 업데이트할 수 있습니다.
lastLoginTime

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

AssignedUserRole

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
필드
assignedUserRoleId

string

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

enum (UserRole)

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

필수 항목입니다.

할당된 사용자 역할이 적용되는 항목의 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, 카테고리, 서드 파티 데이터 제공업체와 같은 클라이언트 안전 보고서만 만들고 관리할 수 있습니다.
CREATIVE 사용자는 공동작업에 필요한 미디어 계획 정보를 볼 수 있지만 비용 관련 데이터나 마켓플레이스는 볼 수 없습니다.
CREATIVE_ADMIN 사용자는 공동작업에 필요한 미디어 계획 정보를 볼 수 있지만 비용 관련 데이터나 마켓플레이스는 볼 수 없습니다. 또한 다른 광고 소재 관리자 또는 광고 소재 사용자를 항목에 추가할 수 있습니다.

메서드

bulkEditAssignedUserRoles

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

create

 새 사용자를 만듭니다.

delete

 사용자를 삭제합니다.

get

 사용자를 가져옵니다.

list

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

patch

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