Bu eğitim, bir Google Analytics hesabına erişmek, Analytics API'lerini sorgulamak, API yanıtlarını yönetmek ve sonuçları almak için atılması gereken adımları adım adım açıklar. Bu eğiticide Core Reporting API v3.0, Management API v3.0 ve OAuth2.0 kullanılmıştır.
1. Adım: Analytics API'yi etkinleştirme
Google Analytics API'yi kullanmaya başlamak için önce kurulum aracını kullanmanız gerekir. Bu araç, Google API Konsolu'nda proje, API'yi etkinleştirme ve kimlik bilgileri oluşturma konusunda size yol gösterir.
İstemci kimliği oluşturma
- Hizmet hesapları sayfasını açın. İstenirse bir proje seçin.
- 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.
- Sonraki Hizmet hesabı izinleri (isteğe bağlı) bölümü gerekli değildir. Devam'ı tıklayın.
- 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.
- Görüntülenen yan panelde anahtar biçimini seçin: JSON önerilir.
- 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.
- Ö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ının bir e-posta adresi (<projectId>-<uniqueId>@developer.gserviceaccount.com) olacak. API aracılığıyla erişmek istediğiniz Google Analytics hesabına kullanıcı eklemek için bu e-posta adresini kullanın.
Bu eğitim için yalnızca Okuma ve Analiz izinleri gerekir.
2. Adım: Google İstemci Kitaplığı'nı yükleyin
Bir paket yöneticisi kullanabilir veya Python istemci kitaplığını manuel olarak indirip yükleyebilirsiniz:
pip
Python paketlerini yüklemek için önerilen araç olan pip'i kullanın:
sudo pip install --upgrade google-api-python-client
Kurulum araçları
setuptools paketinde yer alan easy_install aracını kullanın:
sudo easy_install --upgrade google-api-python-client
Manuel yükleme
Python için istemci kitaplığının en son sürümünü indirin, kodu paketten çıkarın ve şunu çalıştırın:
sudo python setup.py install
Sistemin Python'a yüklenmesi için süper kullanıcı (sudo) ayrıcalıklarına sahip komutu çağırmanız gerekebilir.
3. Adım: Örneği ayarlama
Belirtilen örnek kodunu içerecek HelloAnalytics.py adlı tek bir dosya oluşturmanız gerekir.
- Aşağıdaki kaynak kodunu kopyalayın veya
HelloAnalytics.pyadresine indirin. - Daha önce indirilen
client_secrets.jsonöğesini örnek kodla aynı dizine taşıyın. key_file_locationdeğerlerini, Play Console'daki uygun değerlerle değiştirin.
"""A simple example of how to access the Google Analytics API."""
from apiclient.discovery import build
from oauth2client.service_account import ServiceAccountCredentials
def get_service(api_name, api_version, scopes, key_file_location):
"""Get a service that communicates to a Google API.
Args:
api_name: The name of the api to connect to.
api_version: The api version to connect to.
scopes: A list auth scopes to authorize for the application.
key_file_location: The path to a valid service account JSON key file.
Returns:
A service that is connected to the specified API.
"""
credentials = ServiceAccountCredentials.from_json_keyfile_name(
key_file_location, scopes=scopes)
# Build the service object.
service = build(api_name, api_version, credentials=credentials)
return service
def get_first_profile_id(service):
# Use the Analytics service object to get the first profile id.
# Get a list of all Google Analytics accounts for this user
accounts = service.management().accounts().list().execute()
if accounts.get('items'):
# Get the first Google Analytics account.
account = accounts.get('items')[0].get('id')
# Get a list of all the properties for the first account.
properties = service.management().webproperties().list(
accountId=account).execute()
if properties.get('items'):
# Get the first property id.
property = properties.get('items')[0].get('id')
# Get a list of all views (profiles) for the first property.
profiles = service.management().profiles().list(
accountId=account,
webPropertyId=property).execute()
if profiles.get('items'):
# return the first view (profile) id.
return profiles.get('items')[0].get('id')
return None
def get_results(service, profile_id):
# Use the Analytics Service Object to query the Core Reporting API
# for the number of sessions within the past seven days.
return service.data().ga().get(
ids='ga:' + profile_id,
start_date='7daysAgo',
end_date='today',
metrics='ga:sessions').execute()
def print_results(results):
# Print data nicely for the user.
if results:
print 'View (Profile):', results.get('profileInfo').get('profileName')
print 'Total Sessions:', results.get('rows')[0][0]
else:
print 'No results found'
def main():
# Define the auth scopes to request.
scope = 'https://www.googleapis.com/auth/analytics.readonly'
key_file_location = '<REPLACE_WITH_JSON_FILE>'
# Authenticate and construct service.
service = get_service(
api_name='analytics',
api_version='v3',
scopes=[scope],
key_file_location=key_file_location)
profile_id = get_first_profile_id(service)
print_results(get_results(service, profile_id))
if __name__ == '__main__':
main()
4. Adım: Örneği çalıştırın
Analytics API'yi etkinleştirdikten sonra, Python için Google API'leri istemci kitaplığını yükleyin ve örneğin çalıştırılmaya hazır olduğu örnek kaynak kodunu ayarlayın.
Örneği kullanarak:
python HelloAnalytics.py
Bu adımları tamamladığınızda örnek, yetkili kullanıcının ilk Google Analytics görünümünün adını (profili) ve son yedi gündeki oturum sayısını gösterir.
Yetkili Analytics hizmet nesnesiyle artık Management API'si başvuru dokümanlarında bulunan tüm kod örneklerini çalıştırabilirsiniz. Örneğin, kodu accountSummaries.list yöntemini kullanacak şekilde değiştirmeyi deneyebilirsiniz.
Sorun giderme
Özellik Hatası: 'Module_six_moves_urllib_parse' nesnenin 'urlparse' özelliği yok
Bu hata, Mac® X'te ortaya çıkan ve modüler modülün (bu kitaplığın bağımlılığı) varsayılan kurulumunun, yüklenenden önce yüklenen varsayılan bileşenidir. Sorunu düzeltmek için PYTHONPATH sistem ortamı değişkenine pip' uygulamasının yükleme konumunu ekleyin:
-
Pip' uygulamasının yükleme konumunu aşağıdaki komutla belirleyin:
pip show six | grep "Location:" | cut -d " " -f2 -
Aşağıdaki satırı
~/.bashrcdosyanıza ekleyerek<pip_install_path>öğesini yukarıda belirlenen değerle değiştirin:export PYTHONPATH=$PYTHONPATH:<pip_install_path> -
Aşağıdaki komutu kullanarak
~/.bashrcdosyanızı açık terminal terminallerinde yeniden yükleyin:source ~/.bashrc