Invia feedback
Method: advertisers.lineItems.bulkEditAssignedTargetingOptions
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Display & Video 360 è deprecata e verrà ritirata il 7 ottobre 2025 . Esegui la migrazione alla versione 4 dell'API Display & Video 360 prima del ritiro per evitare un'interruzione del servizio.
Consente di modificare collettivamente le opzioni di targeting in più elementi pubblicitari. L'operazione eliminerà le opzioni di targeting assegnate in BulkEditAssignedTargetingOptionsRequest.delete_requests
e poi creerà le opzioni di targeting assegnate in BulkEditAssignedTargetingOptionsRequest.create_requests
.
Le richieste a questo endpoint non possono essere effettuate contemporaneamente alle seguenti richieste che aggiornano lo stesso elemento pubblicitario:
Non è possibile creare o aggiornare gli elementi pubblicitari YouTube e partner utilizzando l'API.
Richiesta HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
L'URL utilizza la sintassi di transcodifica gRPC .
Parametri del percorso
Parametri
advertiserId
string (int64 format)
Obbligatorio. L'ID dell'inserzionista a cui appartengono gli elementi pubblicitari.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Campi
lineItemIds[]
string (int64 format)
Obbligatorio. L'ID degli elementi pubblicitari di cui viene aggiornato il targeting.
deleteRequests[]
object (DeleteAssignedTargetingOptionsRequest
)
Le opzioni di targeting assegnate da eliminare collettivamente, specificate come elenco di DeleteAssignedTargetingOptionsRequest
.
I tipi di targeting supportati includono:
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_APP
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AUDIENCE_GROUP
TARGETING_TYPE_AUDIO_CONTENT_TYPE
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_BROWSER
TARGETING_TYPE_BUSINESS_CHAIN
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_CHANNEL
TARGETING_TYPE_CONTENT_DURATION
TARGETING_TYPE_CONTENT_GENRE
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_CONTENT_STREAM_TYPE
TARGETING_TYPE_DAY_AND_TIME
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_INVENTORY_SOURCE
TARGETING_TYPE_INVENTORY_SOURCE_GROUP
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
TARGETING_TYPE_OMID
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_POI
TARGETING_TYPE_PROXIMITY_LOCATION_LIST
TARGETING_TYPE_REGIONAL_LOCATION_LIST
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_THIRD_PARTY_VERIFIER
TARGETING_TYPE_URL
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_VIEWABILITY
createRequests[]
object (CreateAssignedTargetingOptionsRequest
)
Le opzioni di targeting assegnate da creare in blocco, specificate come elenco di CreateAssignedTargetingOptionsRequest
.
I tipi di targeting supportati includono:
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_APP
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AUDIENCE_GROUP
TARGETING_TYPE_AUDIO_CONTENT_TYPE
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_BROWSER
TARGETING_TYPE_BUSINESS_CHAIN
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_CHANNEL
TARGETING_TYPE_CONTENT_DURATION
TARGETING_TYPE_CONTENT_GENRE
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_CONTENT_STREAM_TYPE
TARGETING_TYPE_DAY_AND_TIME
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_INVENTORY_SOURCE
TARGETING_TYPE_INVENTORY_SOURCE_GROUP
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
TARGETING_TYPE_OMID
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_POI
TARGETING_TYPE_PROXIMITY_LOCATION_LIST
TARGETING_TYPE_REGIONAL_LOCATION_LIST
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_THIRD_PARTY_VERIFIER
TARGETING_TYPE_URL
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_VIEWABILITY
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON
{
"updatedLineItemIds" : [
string
] ,
"failedLineItemIds" : [
string
] ,
"errors" : [
{
object (Status
)
}
]
}
Campi
updatedLineItemIds[]
string (int64 format)
Solo output. Gli ID degli elementi pubblicitari aggiornati correttamente.
failedLineItemIds[]
string (int64 format)
Solo output. Gli ID degli elementi pubblicitari che non sono riusciti.
errors[]
object (Status
)
Le informazioni sull'errore per ogni elemento pubblicitario 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 sezione OAuth 2.0 Overview .
Invia feedback
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0 , mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0 . Per ulteriori dettagli, consulta le norme del sito di Google Developers . Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-04-02 UTC.
Vuoi dirci altro?
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-04-02 UTC."],[[["This endpoint enables bulk editing of targeting options for multiple line items by deleting and creating assigned targeting options."],["It involves specifying the line item IDs, the targeting options to delete, and the targeting options to create in the request body."],["Concurrent requests updating the same line items using other methods are restricted."],["The response provides details about successfully updated line items, failed line items, and any associated errors."],["Authorization requires the `https://www.googleapis.com/auth/display-video` scope."]]],["This operation performs bulk edits to targeting options for multiple line items. It deletes assigned targeting options specified in `deleteRequests` and creates new ones from `createRequests`. The request includes `lineItemIds` to identify which items to edit. The request is a POST request to a URL with a specific path parameter: `advertiserId`. Concurrent requests to update the same line item are restricted. Successful edits are returned in `updatedLineItemIds`, failures in `failedLineItemIds`, and errors in `errors`.\n"]]