Esta página foi traduzida pela API Cloud Translation.

Guia de início rápido da API sobre como usar a linha de comando

Esta página mostra como começar a usar a API Data v1 do Google Analytics usando o comando linha

Etapa 1. Ativar a API

Clique no botão a seguir para criar automaticamente um novo projeto do Google Cloud ativar a API Google Analytics Data v1 e criar as credenciais do OAuth2 necessárias para tutorial:

Você será redirecionado automaticamente para a configuração de credenciais do OAuth2. caixa de diálogo. Quando a caixa de diálogo De onde você está ligando? aparecer, escolha Computador.

Na caixa de diálogo exibida, clique em FAZER O DOWNLOAD DA CONFIGURAÇÃO DO CLIENTE e salve o arquivo credentials.json ao diretório de trabalho.

Como alternativa, você pode seguir estas etapas para criar uma conta OAuth2 as credenciais em um certificado projeto manualmente.

Etapa 2. Instale e inicialize o SDK do Cloud

Você precisa da linha de comando gcloud instalada na máquina de desenvolvimento.

Etapa 3: fazer uma chamada de API

Agora você pode usar a API Data do Google Analytics para consultar uma .

Selecione uma entidade denunciante

Neste tutorial, usaremos a variável de ambiente GA_PROPERTY_ID para armazenar o ID da propriedade a ser usado nas solicitações da API.

Digite o seguinte na linha de comando para definir a variável GA_PROPERTY_ID:

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

Substitua [YOUR_GA_PROPERTY_ID] pela sua propriedade do Google Analytics identificador. Exemplo:

export GA_PROPERTY_ID=1234567890

Criar o JSON de solicitação

O arquivo request.json a seguir demonstra como criar um relatório simples.

Crie o arquivo de solicitação JSON com o texto a seguir e salve-o como um arquivo de texto simples request.json no seu diretório de trabalho:

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

Autenticar

Para receber as credenciais de usuário neste exemplo, execute o seguinte comando e use O caminho para o arquivo JSON de credenciais salvo na Etapa 1:

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

Uma caixa de diálogo de consentimento do usuário do OAuth será aberta em uma nova janela do navegador.

Enviar a solicitação

Use curl e o conteúdo do corpo de request.json para enviar a solicitação ao API Google Analytics Data. Digite o seguinte na linha de comando:

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA_PROPERTY_ID:runReport -d @request.json

O comando curl usa o gcloud auth application-default print-access-token para receber um token de autenticação.

Para transmitir o nome do arquivo ao curl, use a opção -d (de "dados") e coloque um sinal de @ antes do nome do arquivo. Esse arquivo deve estar no mesmo diretório em que você executa o comando curl.