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ştirinOtomatik 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.