Method: advertisers.lineItems.bulkUpdate

Aggiorna più elementi pubblicitari.

Non è possibile effettuare richieste a questo endpoint contemporaneamente alle seguenti richieste di aggiornamento dello stesso elemento pubblicitario:

Gli elementi pubblicitari YouTube e partner non possono essere creati o aggiornati utilizzando l'API.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
advertiserId

string (int64 format)

obbligatorio. L'ID dell'inserzionista a cui appartiene questo elemento pubblicitario.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Campi
lineItemIds[]

string (int64 format)

obbligatorio. ID degli elementi pubblicitari da aggiornare.
targetLineItem

object (LineItem)

obbligatorio. Un oggetto elemento pubblicitario contenente i campi da aggiornare e i nuovi valori da assegnare a tutti gli elementi pubblicitari specificati in lineItemIds."
updateMask

string (FieldMask format)

obbligatorio. Una maschera dei campi che identifica i campi da aggiornare.

Attualmente sono supportati solo i seguenti campi:

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

Corpo della risposta

Messaggio di risposta per LineItemService.bulkUpdateLineItems.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Campi
updatedLineItemIds[]

string (int64 format)

Gli ID degli elementi pubblicitari aggiornati correttamente.
failedLineItemIds[]

string (int64 format)

Gli ID degli elementi pubblicitari che non è stato possibile aggiornare.
skippedLineItemIds[]

string (int64 format)

Gli ID degli elementi pubblicitari che vengono ignorati per gli aggiornamenti. Ad esempio, modifiche non necessarie che comportano l'assenza di modifiche agli elementi pubblicitari verranno ignorate e gli ID degli elementi pubblicitari corrispondenti potranno essere monitorati qui.
errors[]

object (Status)

Errori restituiti dagli elementi pubblicitari che non è stato possibile aggiornare.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.