Method: advertisers.lineItems.bulkEditAssignedTargetingOptions
A API Display & Video 360 foi descontinuada e será desativada em 7 de outubro de 2025 . Migrar para a API Display & Video 360 v4 antes da desativação para evitar a interrupção do serviço.
Solicitação HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
O URL usa a sintaxe de transcodificação gRPC .
Parâmetros de caminho
Parâmetros
advertiserId
string (int64 format)
Obrigatório. O ID do anunciante a que os itens de linha pertencem.
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Campos
lineItemIds[]
string (int64 format)
Obrigatório. O ID dos itens de linha cuja segmentação está sendo atualizada.
deleteRequests[]
object (DeleteAssignedTargetingOptionsRequest
)
As opções de segmentação atribuídas a serem excluídas em lote, especificadas como uma lista de DeleteAssignedTargetingOptionsRequest
.
Os tipos de segmentação aceitos são:
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
)
As opções de segmentação atribuídas a serem criadas em lote, especificadas como uma lista de CreateAssignedTargetingOptionsRequest
.
Os tipos de segmentação aceitos são:
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 da resposta
Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:
Representação JSON
{
"updatedLineItemIds" : [
string
] ,
"failedLineItemIds" : [
string
] ,
"errors" : [
{
object (Status
)
}
]
}
Campos
updatedLineItemIds[]
string (int64 format)
Apenas saída. Os IDs dos itens de linha que foram atualizados.
failedLineItemIds[]
string (int64 format)
Apenas saída. Os IDs dos itens de linha que falharam.
errors[]
object (Status
)
As informações de erro de cada item de linha que não foi atualizado.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/display-video
Para mais informações, consulte OAuth 2.0 Overview .
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons , e as amostras de código são licenciadas de acordo com a Licença Apache 2.0 . Para mais detalhes, consulte as políticas do site do Google Developers . Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-02 UTC.
[null,null,["Última atualização 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"]]