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:

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

Richiesta HTTP

POST https://displayvideo.googleapis.com/v3/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 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 la cui aggiornamento non è riuscito.
skippedLineItemIds[]

string (int64 format)

Gli ID degli elementi pubblicitari ignorati per gli aggiornamenti. Ad esempio, le mutazioni non necessarie che non comportano modifiche agli elementi pubblicitari verranno ignorate e gli ID elemento pubblicitario corrispondenti possono essere monitorati qui.
errors[]

object (Status)

Errori restituiti dagli elementi pubblicitari di cui non è stato possibile aggiornare i dati.

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.