Komut satırını kullanarak API Hızlı Başlangıç Kılavuzu

Bu sayfada, Google Analytics Data API v1'i komut satırını kullanarak nasıl kullanmaya başlayacağınız gösterilmektedir.

1. Adım: API'yi etkinleştirme

Yeni bir Cloud Platform projesi oluşturmak, Google Analytics Data API v1'i otomatik olarak etkinleştirmek ve eğitim için gereken OAuth2 kimlik bilgilerini oluşturmak için bu düğmeyi tıklayın:

Google Analytics Data API v1'i etkinleştirin

Otomatik olarak OAuth2 kimlik bilgileri yapılandırma iletişim kutusuna yönlendirilirsiniz. "Nereden arıyorsunuz?" sorusuyla karşılaştığınızda "Masaüstü"nü seçin.

Açılan iletişim kutusunda İSTEMCİ YAPILANDIRMASINI İNDİR'i tıklayın ve credentials.json dosyasını çalışma dizininize kaydedin.

Alternatif olarak, mevcut bir projede manuel olarak OAuth2 Kimlik Bilgileri oluşturma adımlarını uygulayabilirsiniz.

2. adım: Google Cloud SDK'yı yükleme ve başlatma

Geliştirme makinenizde gcloud komut satırı aracının yüklü olması gerekir.

3. Adım: API çağrısı yapın

Artık bir Google Analytics 4 mülkünü sorgulamak için Google Analytics Data API'yi kullanabilirsiniz.

Rapor Eden Varlık Seçin

Bu eğiticide, API isteklerinde kullanılacak mülk kimliğini depolamak için GA4_PROPERTY_ID ortam değişkenini kullanacağız.

GA4_PROPERTY_ID değişkenini ayarlamak için komut satırınıza aşağıdaki komutu girin:

export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]

[YOUR-GA4-PROPERTY-ID] kısmını Google Analytics 4 mülk tanımlayıcınızla değiştirin. Örneğin:

export GA4_PROPERTY_ID=1234567890

İstek JSON'unu oluşturun

Aşağıdaki request.json dosyası, basit bir raporun nasıl oluşturulacağını gösterir.

Aşağıdaki metinle birlikte JSON istek dosyasını oluşturun ve bunu çalışma dizininize request.json düz metin dosyası olarak kaydedin:

request.json

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

Kimliği doğrula

Bu örnekte kullanıcı kimlik bilgilerini almak için aşağıdaki komutu çalıştırın ve 1. adımda indirdiğiniz kimlik bilgileri JSON dosyasının yolunu kullanın:

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

Yeni bir tarayıcı penceresinde OAuth kullanıcı izni iletişim kutusu açılır.

İsteği gönder

İsteği Google Analytics Data API'ye göndermek için curl öğesini ve request.json dosyasındaki gövde içeriğini kullanın. Komut satırınıza aşağıdaki komutu girin:

  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/$GA4_PROPERTY_ID:runReport -d @request.json

curl komutu, kimlik doğrulama jetonu almak için gcloud auth application-default print-access-token komutunu kullanır.

Curl'ye eklemek için bir dosya adı iletmek üzere -d seçeneğini ("veriler" için) kullandığınızı ve dosya adının önüne @ işareti koyduğunuzu unutmayın. Bu dosya, curl komutunu yürüttüğünüz dizinde olmalıdır.

Tebrikler! Google Analytics Data API'ye ilk isteğinizi gönderdiniz.