Method: advertisers.lineItems.bulkUpdate

여러 광고 항목을 업데이트합니다.

이 엔드포인트에 대한 요청은 동일한 항목을 업데이트하는 다음 요청과 동시에 실행할 수 없습니다.

YouTube 및 파트너 광고 항목은 API를 사용하여 만들거나 업데이트할 수 없습니다.

HTTP 요청

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate

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

경로 매개변수

매개변수
advertiserId

string (int64 format)

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

요청 본문

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

JSON 표현
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
필드
lineItemIds[]

string (int64 format)

필수 항목입니다. 업데이트할 광고 항목의 ID입니다.

targetLineItem

object (LineItem)

필수 항목입니다. 업데이트할 입력란과 lineItemIds에 지정된 모든 광고 항목에 할당할 새 값이 포함된 광고 항목 객체입니다.

updateMask

string (FieldMask format)

필수 항목입니다. 업데이트할 필드를 식별하는 필드 마스크입니다.

현재 다음 필드만 지원됩니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

응답 본문

LineItemService.BulkUpdateLineItems의 응답 메시지입니다.

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

JSON 표현
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
필드
updatedLineItemIds[]

string (int64 format)

성공적으로 업데이트된 광고 항목의 ID입니다.

failedLineItemIds[]

string (int64 format)

업데이트에 실패한 광고 항목의 ID입니다.

skippedLineItemIds[]

string (int64 format)

업데이트를 위해 건너뛰는 광고 항목의 ID입니다. 예를 들어 사실상 광고 항목을 변경하지 않게 되는 불필요한 변경은 건너뛰게 되며 여기에서 해당 광고 항목 ID를 추적할 수 있습니다.

errors[]

object (Status)

업데이트에 실패한 광고 항목에서 반환된 오류입니다.

승인 범위

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

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

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