CreativeGroups: list

Recupera uma lista de grupos de criativos, possivelmente filtrada. Esse método é compatível com paginação. Faça um teste agora.

Solicitação

Solicitação HTTP

GET https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/creativeGroups

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
profileId long ID do perfil de usuário associado a esta solicitação.
Parâmetros de consulta opcionais
advertiserIds long Seleciona somente os grupos de criativos que pertençam a estes anunciantes.
groupNumber integer Seleciona somente os grupos de criativos que pertençam a este subgrupo. Os valores aceitos vão de 1 a 2.
ids long Seleciona somente grupos de criativos com estes IDs.
maxResults integer É o número máximo de resultados para retornar. Os valores aceitos vão de 0 a 1000. Padrão: 1000
pageToken string É o valor de nextPageToken da página de resultados anterior.
searchString string Permite pesquisar grupos de criativos por nome ou ID. Caracteres curinga (*) são permitidos. Por exemplo, "creativegroup*2015" retornará grupos de criativos com nomes como "creativegroup June 2015", "creativegroup April 2015" ou simplesmente "creativegroup 2015". A maioria das pesquisas também adiciona caracteres curinga implicitamente no começo e no fim da string de pesquisa. Por exemplo, uma string de pesquisa de "creativegroup" corresponderá a grupos de criativos com o nome "my creativegroup", "creativegroup 2015" ou simplesmente "creativegroup".
sortField string É o campo que classificará a lista.

Os valores aceitáveis são:
  • "ID" (padrão)
  • "NAME"
sortOrder string Ordem dos resultados classificados.

Os valores aceitáveis são:
  • "ASCENDING" (padrão)
  • "DESCENDING"

Autorização

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

Escopo
https://www.googleapis.com/auth/dfatrafficking

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

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

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

{
  "kind": "dfareporting#creativeGroupsListResponse",
  "nextPageToken": string,
  "creativeGroups": [
    creativeGroups Resource
  ]
}
Nome da propriedade Valor Descrição Notas
kind string Identifica o tipo de recurso. Valor: a string fixa "dfareporting#creativeGroupsListResponse".
nextPageToken string É o token de paginação a ser usado para a próxima operação da lista.
creativeGroups[] list É uma coleção de grupos de criativos.

Faça um teste

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.