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

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