REST Resource: users

리소스: User

디스플레이의 사용자 1명 및 동영상 360

JSON 표현 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
필드
name

string

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

string (int64 format)

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

string

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

string

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

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

object (AssignedUserRole)

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

users.create에서 필수입니다. users.patch에서만 출력됩니다. users.bulkEditAssignedUserRoles까지만 업데이트할 수 있습니다.

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

메서드

bulkEditAssignedUserRoles

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

create

 신규 사용자를 만듭니다.

delete

 사용자를 삭제합니다.

get

 사용자를 가져옵니다.

list

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

patch

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