Method: properties.audienceExports.query

Recupera uma exportação de público-alvo de usuários. Depois de criar um público-alvo, os usuários não ficam disponíveis imediatamente para exportação. Primeiro, é necessário fazer uma solicitação para audienceExports.create a fim de criar uma exportação de público-alvo de usuários. Depois, esse método é usado para recuperar os usuários na exportação de público-alvo.

Consulte Criar uma exportação de público-alvo para uma introdução às exportações de público-alvo com exemplos.

Com os públicos-alvo no Google Analytics 4, você pode segmentar os usuários de acordo com o que é importante para sua empresa. Saiba mais em https://support.google.com/analytics/answer/9267572.

As APIs de exportação de público-alvo têm alguns métodos em estabilidade alfa e outros em beta. A intenção é avançar os métodos para a estabilidade Beta após algum feedback e adoção. Para enviar feedback sobre essa API, preencha o formulário Feedback da API Audience Export do Google Analytics.

Solicitação HTTP

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome da exportação de público-alvo para recuperar usuários. Formato: properties/{property}/audienceExports/{audienceExport}

Corpo da solicitação

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

Representação JSON 
{
  "offset": string,
  "limit": string
}
Campos
offset

string (int64 format)

Opcional. A contagem de linhas da linha inicial. A primeira linha é contada como linha 0.

Ao paginar, a primeira solicitação não especifica o deslocamento ou, de maneira equivalente, define o deslocamento como 0. A primeira solicitação retorna as primeiras limit linhas. A segunda solicitação define o deslocamento como o limit da primeira solicitação, e retorna o segundo limit de linhas.

Para saber mais sobre esse parâmetro de paginação, consulte Paginação.
limit

string (int64 format)

Opcional. O número de linhas que serão retornadas. Se não for especificado, 10.000 linhas serão retornadas. A API retorna no máximo 250.000 linhas por solicitação, não importa quantas você peça. limit precisa ser positivo.

A API também pode retornar menos linhas do que o limit solicitado, se não houver tantos valores de dimensão quanto o limit.

Para saber mais sobre esse parâmetro de paginação, consulte Paginação.

Corpo da resposta

Uma lista de usuários em uma exportação de público-alvo.

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

Representação JSON 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
Campos
audienceRows[]

object (AudienceRow)

Linhas para cada usuário em uma exportação de público-alvo. O número de linhas nessa resposta será menor ou igual ao tamanho da página da solicitação.
audienceExport

object (AudienceExport)

Dados de configuração sobre o AudienceExport que está sendo consultado. Retornado para ajudar a interpretar as linhas de público-alvo nesta resposta. Por exemplo, as dimensões em "AudienceExport" correspondem às colunas em "AudienceRows".
rowCount

integer

O número total de linhas no resultado AudienceExport. rowCount é independente do número de linhas retornadas na resposta, do parâmetro de solicitação limit e do parâmetro de solicitação offset. Por exemplo, se uma consulta retornar 175 linhas e incluir limit de 50 na solicitação de API, a resposta vai conter rowCount de 175, mas apenas 50 linhas.

Para saber mais sobre esse parâmetro de paginação, consulte Paginação.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

AudienceRow

Atributos de valor da dimensão para a linha de usuário do público-alvo.

Representação JSON 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
Campos
dimensionValues[]

object (AudienceDimensionValue)

Cada atributo de valor de dimensão para um usuário do público-alvo. Um valor de dimensão será adicionado para cada coluna de dimensão solicitada.

AudienceDimensionValue

O valor de uma dimensão.

Representação JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "value": string
  // End of mutually exclusive fields.
}
Campos
Um tipo de valor de dimensão. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
value

string

Valor como uma string se o tipo de dimensão for uma string.
Fim dos campos mutuamente exclusivos.