Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

여러 광고그룹의 타겟팅 옵션을 일괄 수정합니다.

동일한 삭제 및 생성 요청 집합이 지정된 모든 광고그룹에 적용됩니다. 특히 이 작업은 각 광고그룹에서 BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests에 제공된 할당된 타겟팅 옵션을 삭제한 후 BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests에 제공된 할당된 타겟팅 옵션을 만듭니다.

이 메서드는 디맨드젠 광고그룹에서만 지원됩니다.

HTTP 요청

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

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

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. 광고그룹이 속한 광고주의 ID입니다.

요청 본문

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

JSON 표현 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
필드
adGroupIds[]

string (int64 format)

필수 항목입니다. 할당된 타겟팅 옵션이 속할 광고그룹의 ID입니다. 최대 25개의 광고그룹 ID를 지정할 수 있습니다.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

선택사항입니다. DeleteAssignedTargetingOptionsRequest 목록으로 지정된 일괄 삭제할 할당된 타겟팅 옵션입니다.

지원되는 타겟팅 유형:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

선택사항입니다. CreateAssignedTargetingOptionRequest 목록으로 지정된 일괄 생성할 할당된 타겟팅 옵션입니다.

지원되는 타겟팅 유형:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

응답 본문

adGroups.bulkEditAssignedTargetingOptions의 응답 메시지입니다.

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

JSON 표현 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
필드
updatedAdGroupIds[]

string (int64 format)

출력 전용입니다. 업데이트된 광고그룹의 ID입니다.
failedAdGroupIds[]

string (int64 format)

출력 전용입니다. 업데이트하지 못한 광고그룹의 ID입니다.
errors[]

object (Status)

출력 전용입니다. 업데이트하지 못한 각 광고그룹의 오류 정보입니다.

승인 범위

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

  • https://www.googleapis.com/auth/display-video

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