Method: customers.adGroupAssetSets.mutate

광고 그룹 확장 소재 세트를 만들거나 삭제합니다. 작업 상태가 반환됩니다.

HTTP 요청

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 광고 그룹 확장 소재 세트를 수정 중인 고객의 ID입니다.

요청 본문

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

JSON 표현 
{
  "operations": [
    {
      object (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
필드
operations[]

object (AdGroupAssetSetOperation)

필수 항목입니다. 개별 광고 그룹 확장 소재 세트에서 실행할 작업 목록입니다.
partialFailure

boolean

true인 경우 성공적인 작업이 실행되고 잘못된 작업은 오류를 반환합니다. false인 경우 모든 작업이 모두 유효한 경우에만 하나의 트랜잭션으로 실행됩니다. 기본값은 false입니다.
validateOnly

boolean

true인 경우 요청이 검증되지만 실행되지 않습니다. 결과가 아닌 오류만 반환됩니다.
responseContentType

enum (ResponseContentType)

응답 콘텐츠 유형 설정입니다. 변경 후 변경 가능한 리소스 또는 리소스 이름만 반환할지 결정합니다.

응답 본문

광고 그룹 확장 소재 세트 변형에 대한 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "results": [
    {
      object (MutateAdGroupAssetSetResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
필드
results[]

object (MutateAdGroupAssetSetResult)

변형의 모든 결과입니다.
partialFailureError

object (Status)

부분 실패 모드의 작업 실패와 관련된 오류입니다. partialFailure = true이고 모든 오류가 작업 내부에서 발생하는 경우에만 반환됩니다. 작업 외부에서 오류가 발생하면(예: 인증 오류) RPC 수준 오류가 반환됩니다.

승인 범위

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

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

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

AdGroupAssetSetOperation

광고그룹 애셋 세트에 대한 단일 작업 (만들기, 삭제)입니다.

JSON 표현 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
필드
통합 필드 operation. 변경 작업 operation은 다음 중 하나여야 합니다.
create

object (AdGroupAssetSet)

만들기 작업: 새 광고 그룹 확장 소재 세트에는 리소스 이름이 없습니다.
remove

string

삭제 작업: 삭제된 광고 그룹 확장 소재 세트의 리소스 이름이 customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id} 형식으로 표시됩니다.

MutateAdGroupAssetSetResult

광고 그룹 확장 소재 세트의 결과가 변경됩니다.

JSON 표현 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
필드
resourceName

string

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

object (AdGroupAssetSet)

변경 후 변경 가능한 필드만 있는 변형된 광고 그룹 확장 소재 이 필드는 responseContentType이 'MUTABLE_RESOURCE'로 설정된 경우에만 반환됩니다.