Method: sellers.adUnits.impressionSchedules.batchUpdate

  • This document details how to update impression schedules in batch using the batchUpdate method.

  • The maximum number of impression schedules allowed in a single batch update is 1000.

  • A successful batch update returns the updated impression schedules.

  • An INVALID_ARGUMENT error is returned if an attempt is made to change an immutable field.

  • The method requires OAuth scope https://www.googleapis.com/auth/doubleclickbidmanager for authorization.

Updates impression schedules in batch.

  • Max allowed number of impression schedules in a batch is 1000.
  • Returns the updated impression schedules if successful.
  • Returns error code INVALID_ARGUMENT if an immutable field is specified in updateMask and a change is requested.

HTTP request

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource name. Format: sellers/{seller}/adUnits/{adUnit}

Request body

The request body contains data with the following structure:

JSON representation 
{
  "requests": [
    {
      object (UpdateImpressionScheduleRequest)
    }
  ]
}
Fields
requests[]

object (UpdateImpressionScheduleRequest)

Required. The impression schedule to update.

Max allowed number of impression schedule in a batch is 1000.

Response body

If successful, the response body contains data with the following structure:

Response message for InventoryService.BatchUpdateImpressionSchedules.

JSON representation 
{
  "impressionSchedule": [
    {
      object (ImpressionSchedule)
    }
  ]
}
Fields
impressionSchedule[]

object (ImpressionSchedule)

The updated impression schedule.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

UpdateImpressionScheduleRequest

Request message for InventoryService.UpdateImpressionSchedule.

JSON representation 
{
  "impressionSchedule": {
    object (ImpressionSchedule)
  },
  "updateMask": string
}
Fields
impressionSchedule

object (ImpressionSchedule)

Required. The partial impression schedule with updated fields.

The following fields are required: * name - used to identity which impression schedule to update.
updateMask

string (FieldMask format)

Required. The mask to control which fields to update.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".