- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Aggiorna più elementi pubblicitari.
Non è possibile effettuare richieste a questo endpoint contemporaneamente alle seguenti richieste di aggiornamento dello stesso elemento pubblicitario:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
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 |
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 ( |
Campi | |
---|---|
lineItemIds[] |
obbligatorio. ID degli elementi pubblicitari da aggiornare. |
targetLineItem |
obbligatorio. Un oggetto elemento pubblicitario contenente i campi da aggiornare e i nuovi valori da assegnare a tutti gli elementi pubblicitari specificati in |
updateMask |
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: |
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 ( |
Campi | |
---|---|
updatedLineItemIds[] |
Gli ID degli elementi pubblicitari aggiornati correttamente. |
failedLineItemIds[] |
Gli ID degli elementi pubblicitari che non è stato possibile aggiornare. |
skippedLineItemIds[] |
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[] |
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.