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를 참고하세요.