Method: advertisers.lineItems.bulkUpdate

Aggiorna più elementi pubblicitari.

Impossibile effettuare richieste a questo endpoint in concomitanza con le seguenti richieste per aggiornare lo stesso elemento pubblicitario:

YouTube e Gli elementi pubblicitari dei 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 di campo che identifica i campi da aggiornare.

Al momento sono supportati solo i seguenti campi:

Si tratta di un elenco di nomi completi dei campi separati da virgole. 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 la cui aggiornamento non è riuscito.

skippedLineItemIds[]

string (int64 format)

Gli ID degli elementi pubblicitari che vengono ignorati per gli aggiornamenti. Ad esempio, le mutazioni non necessarie che comporteranno effettivamente 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 panoramica di OAuth 2.0.