Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Edita em massa as opções de segmentação de vários grupos de anúncios.

O mesmo conjunto de solicitações de exclusão e criação será aplicado a todos os grupos de anúncios especificados. Especificamente, a operação vai excluir as opções de segmentação atribuídas fornecidas em BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests de cada grupo de anúncios e criar as opções de segmentação atribuídas fornecidas em BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests.

Esse método só é compatível com grupos de anúncios Geração de demanda.

Solicitação HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups: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 grupos de anúncios pertencem.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Campos
adGroupIds[]

string (int64 format)

Obrigatório. Os IDs dos grupos de anúncios a que as opções de segmentação atribuídas pertencem. É possível especificar no máximo 25 IDs de grupo de anúncios.

deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

Opcional. As opções de segmentação atribuídas a serem excluídas em lote, especificadas como uma lista de DeleteAssignedTargetingOptionsRequest.

Tipos de segmentação compatíveis:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

Opcional. As opções de segmentação atribuídas a serem criadas em lote, especificadas como uma lista de CreateAssignedTargetingOptionRequest.

Tipos de segmentação compatíveis:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Corpo da resposta

Mensagem de resposta para adGroups.bulkEditAssignedTargetingOptions.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Campos
updatedAdGroupIds[]

string (int64 format)

Apenas saída. Os IDs dos grupos de anúncios que foram atualizados.

failedAdGroupIds[]

string (int64 format)

Apenas saída. Os IDs dos grupos de anúncios que não foram atualizados.

errors[]

object (Status)

Apenas saída. As informações de erro de cada grupo de anúncios 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.