Merhaba Analytics Reporting API v4; Hizmet hesapları için Python hızlı başlangıç kılavuzu

Bu eğitimde, Analytics Reporting API v4'e erişmek için gereken adımlar açıklanmaktadır.

1. API'yi etkinleştirme

Analytics Reporting API v4'ü kullanmaya başlamak için önce kurulum aracını kullanmanız gerekir. Bu araç, Google API Konsolu'nda proje oluşturma, API'yi etkinleştirme ve kimlik bilgileri oluşturma konusunda size rehberlik eder.

Kimlik bilgileri oluştur

  1. Hizmet hesapları sayfasını açın. İstenirse bir proje seçin.
  2. Hizmet Hesabı Oluştur'u tıklayın, hizmet hesabı için bir ad ve açıklama girin. Varsayılan hizmet hesabı kimliğini kullanabilir veya farklı, benzersiz bir tane seçebilirsiniz. Tamamladıktan sonra Oluştur'u tıklayın.
  3. Sonraki Hizmet hesabı izinleri (isteğe bağlı) bölümü gerekli değildir. Devam'ı tıklayın.
  4. Kullanıcıların bu hizmet hesabına erişmelerine izin ver ekranında, Anahtar oluştur bölümüne gidin. Anahtar oluştur'u tıklayın.
  5. Görüntülenen yan panelde anahtar biçimini seçin: JSON önerilir.
  6. Oluştur'u tıklayın. Herkese açık/özel yeni anahtar çiftiniz oluşturulur ve makinenize indirilir; bu anahtarın tek kopyası olarak işlev görür. Güvenli şekilde nasıl depolanacağını öğrenmek için Hizmet hesabı anahtarlarını yönetme konusuna bakın.
  7. Özel anahtar bilgisayarınıza kaydedildi iletişiminde Kapat'ı tıklayın. Ardından hizmet hesapları tablosuna dönmek için Tamam'ı tıklayın.

Google Analytics hesabına hizmet hesabı ekleme

Yeni oluşturulan hizmet hesabı, aşağıdakine benzer bir e-posta adresine sahip olur:

quickstart@PROJECT-ID.iam.gserviceaccount.com

API ile erişmek istediğiniz Google Analytics görünümüne bir kullanıcı eklemek için bu e-posta adresini kullanın. Bu eğitim için yalnızca Okuma ve Analiz izinleri gereklidir.

2. İstemci kitaplığını yükleme

Python paketlerini yüklemek için vepv ile birlikte venv'i kullanmanız önerilir: sudo -s apt-get install python3-venv python3 -m venv analytics-quickstart source analytics-quickstart/bin/activate pip install --upgrade google-api-python-client pip install --upgrade oauth2client

3. Örneği ayarlama

Belirtilen örnek kodunu içerecek, HelloAnalytics.py adlı tek bir dosya oluşturmanız gerekir.

  1. Aşağıdaki kaynak kodunu kopyalayın veya HelloAnalytics.py adresine indirin.
  2. Daha önce indirilen client_secrets.json öğesini örnek kodla aynı dizine taşıyın.
  3. KEY_FILE_LOCATION değerini, indirilen client_secrets.json öğesine uygun yol ile değiştirin.
  4. VIEW_ID değerini değiştirin. Görünüm Kimliğini bulmak için Hesap Gezgini'ni kullanabilirsiniz. 
"""Hello Analytics Reporting API V4."""

from apiclient.discovery import build
from oauth2client.service_account import ServiceAccountCredentials


SCOPES = ['https://www.googleapis.com/auth/analytics.readonly']
KEY_FILE_LOCATION = '<REPLACE_WITH_JSON_FILE>'
VIEW_ID = '<REPLACE_WITH_VIEW_ID>'


def initialize_analyticsreporting():
  """Initializes an Analytics Reporting API V4 service object.

  Returns:
    An authorized Analytics Reporting API V4 service object.
  """
  credentials = ServiceAccountCredentials.from_json_keyfile_name(
      KEY_FILE_LOCATION, SCOPES)

  # Build the service object.
  analytics = build('analyticsreporting', 'v4', credentials=credentials)

  return analytics


def get_report(analytics):
  """Queries the Analytics Reporting API V4.

  Args:
    analytics: An authorized Analytics Reporting API V4 service object.
  Returns:
    The Analytics Reporting API V4 response.
  """
  return analytics.reports().batchGet(
      body={
        'reportRequests': [
        {
          'viewId': VIEW_ID,
          'dateRanges': [{'startDate': '7daysAgo', 'endDate': 'today'}],
          'metrics': [{'expression': 'ga:sessions'}],
          'dimensions': [{'name': 'ga:country'}]
        }]
      }
  ).execute()


def print_response(response):
  """Parses and prints the Analytics Reporting API V4 response.

  Args:
    response: An Analytics Reporting API V4 response.
  """
  for report in response.get('reports', []):
    columnHeader = report.get('columnHeader', {})
    dimensionHeaders = columnHeader.get('dimensions', [])
    metricHeaders = columnHeader.get('metricHeader', {}).get('metricHeaderEntries', [])

    for row in report.get('data', {}).get('rows', []):
      dimensions = row.get('dimensions', [])
      dateRangeValues = row.get('metrics', [])

      for header, dimension in zip(dimensionHeaders, dimensions):
        print(header + ': ', dimension)

      for i, values in enumerate(dateRangeValues):
        print('Date range:', str(i))
        for metricHeader, value in zip(metricHeaders, values.get('values')):
          print(metricHeader.get('name') + ':', value)


def main():
  analytics = initialize_analyticsreporting()
  response = get_report(analytics)
  print_response(response)

if __name__ == '__main__':
  main()

4. Örneği çalıştırma

Örneği kullanarak:

python HelloAnalytics.py

Bu adımları tamamladığınızda örnek, söz konusu görünüm için son yedi gündeki oturum sayısını gösterir.

Sorun giderme

Özellik Hatası: 'Module_six_moves_urllib_parse' nesnenin 'urlparse' özelliği yok

Bu hata, Mac® X'te ortaya çıkan ve "altı birim" modülünün (bu kitaplığın bağımlılığı) varsayılan kurulumunun, yüklenen pifiden önce yüklendiği durumlarda gerçekleşir. Bu sorunu düzeltmek için pip' uygulamasının yükleme konumunu PYTHONPATH sistem ortamı değişkenine ekleyin:

  • Pip' uygulamasının yükleme konumunu aşağıdaki komutla belirleyin:

    pip göster altı | grep "Konum:" | kes -d " " -f2

  • Aşağıdaki satırı ~/.bashrc dosyanıza ekleyerek &lt;pip_install_path&gt; alanını yukarıda belirtilen değerle değiştirin:

    dışa aktarma PÎONPATH=$PÎONPATH:<pip_install_path>

  • Aşağıdaki komutu kullanarak ~/.bashrc dosyanızı tüm açık terminal pencerelerinde yeniden yükleyin:

    kaynak ~/.bashrc