A API Search Ads 360 Reporting anterior será desativada em 30 de junho de 2024. A API Search Ads 360 Conversion não foi afetada e vai continuar compatível. Todo novo desenvolvimento de relatórios precisa usar a nova API Search Ads 360 Reporting.

A partir de abril de 2024, um erro supportedApiVersion será retornado ao solicitar um relatório. Veja os detalhes aqui.

Também é altamente recomendável migrar as implementações atuais do Search Ads 360 para a nova API. Consulte o Guia de introdução e o Guia de migração da nova API Search Ads 360 Reporting para saber mais informações.

Esta página foi traduzida pela API Cloud Translation.

Conversion: updateAvailability

Atualiza as disponibilidades de um lote de atividades do Floodlight no DoubleClick Search. Faça o teste agora.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability

Autorização

Esta solicitação requer autorização com o seguinte escopo:

Escopo
`https://www.googleapis.com/auth/doubleclicksearch`

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

No corpo da solicitação, forneça os dados com a seguinte estrutura:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}

Nome da propriedade	Valor	Descrição
`availabilities[]`	`list`	Disponibilidades solicitadas
`availabilities[].agencyId`	`long`	ID da agência do DS.
`availabilities[].advertiserId`	`long`	ID do anunciante do DS.
`availabilities[].segmentationType`	`string`	É o tipo de segmentação para essa disponibilidade. O valor padrão é `FLOODLIGHT`. Os valores aceitáveis são os seguintes: "`FLOODLIGHT`"
`availabilities[].segmentationId`	`long`	É o identificador de segmentação numérica (por exemplo, o ID da atividade do Floodlight do DoubleClick Search).
`availabilities[].segmentationName`	`string`	O identificador de segmentação de fácil utilização (por exemplo, nome da atividade do Floodlight do DoubleClick Search).
`availabilities[].availabilityTimestamp`	`unsigned long`	O horário de upload de todas as conversões, em milissegundos.
`availabilities[].customerId`	`string`	Novo ID de cliente do Search Ads 360. Precisa ser uma conta de subadministrador.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}

Nome da propriedade	Valor	Descrição
`availabilities[]`	`list`	Disponibilidades retornadas.
`availabilities[].agencyId`	`long`	ID da agência do DS.
`availabilities[].advertiserId`	`long`	ID do anunciante do DS.
`availabilities[].segmentationType`	`string`	É o tipo de segmentação para essa disponibilidade. O valor padrão é `FLOODLIGHT`. Os valores aceitáveis são os seguintes: "`FLOODLIGHT`"
`availabilities[].segmentationId`	`long`	É o identificador de segmentação numérica (por exemplo, o ID da atividade do Floodlight do DoubleClick Search).
`availabilities[].segmentationName`	`string`	O identificador de segmentação de fácil utilização (por exemplo, nome da atividade do Floodlight do DoubleClick Search).
`availabilities[].availabilityTimestamp`	`unsigned long`	O horário de upload de todas as conversões, em milissegundos.
`availabilities[].customerId`	`string`	Novo ID de cliente do Search Ads 360. Precisa ser uma conta de subadministrador.

Confira!

Use o APIs Explorer abaixo para chamar esse método para dados ativos e ver a resposta. Se você preferir, teste o Explorador independente.