Method: customers.customerUserAccesses.mutate

특정 고객에 대한 사용자의 권한을 업데이트하거나 삭제합니다. 작업 상태가 반환됩니다.

발생한 오류 목록: AuthenticationError AuthorizationError CustomerUserAccessError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

HTTP 요청

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerUserAccesses:mutate

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 수정되는 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
필드
operation

object (CustomerUserAccessOperation)

필수 항목입니다. 고객에 대해 수행할 작업입니다.

응답 본문

고객 사용자 액세스 변경에 대한 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
필드
result

object (MutateCustomerUserAccessResult)

변경의 결과입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/adwords

자세한 내용은 OAuth 2.0 개요를 참고하세요.

CustomerUserAccessOperation

고객 사용자 액세스에 대한 단일 작업 (업데이트, 삭제)입니다.

JSON 표현 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerUserAccess)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
필드
updateMask

string (FieldMask format)

업데이트 시 수정되는 리소스 필드를 결정하는 FieldMask입니다.

필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: "user.displayName,photo"
통합 필드 operation. 변경 연산입니다. operation은 다음 중 하나여야 합니다.
update

object (CustomerUserAccess)

업데이트 작업: 고객 사용자 액세스에 유효한 리소스 이름이 있어야 합니다.
remove

string

삭제 작업: 삭제된 액세스의 리소스 이름은 다음 형식으로 필요합니다.

customers/{customerId}/customerUserAccesses/{CustomerUserAccess.user_id}

MutateCustomerUserAccessResult

고객 사용자 액세스 변경의 결과입니다.

JSON 표현 
{
  "resourceName": string
}
필드
resourceName

string

작업이 성공하면 반환됩니다.