Bayiler için Python hızlı başlangıç kılavuzu

Bu hızlı başlangıç kılavuzundaki adımları uygulayın. Yaklaşık 10 dakika içinde el değmeden kayıt bayi API'sine istek gönderen basit bir Python komut satırı uygulamasına sahip olacaksınız.

Ön koşullar

Bu hızlı başlangıç kılavuzunu çalıştırmak için şunlar gerekir:

  • El değmeden kayıt özellikli bayi hesabınızın üyesi olan bir Google Hesabı. Henüz ilk katılım işlemini tamamlamadıysanız Bayi portalı kılavuzundaki Başlayın bölümündeki adımları uygulayın.
  • Python 2.6 veya sonraki sürümler
  • pip paket yönetim aracı.
  • İnternete ve web tarayıcıya erişim.

1. adım: El değmeden kayıt API'sini etkinleştirin

  1. Google Developers Console'da proje oluşturmak veya mevcut bir projeyi seçmek ve API'yi otomatik olarak etkinleştirmek için bu sihirbazı kullanın. Devam'ı, ardından Kimlik bilgilerine git'i tıklayın.
  2. Hangi verilere erişeceksiniz? alanını Uygulama verileri olarak ayarlayın.
  3. İleri'yi tıklayın. Hizmet hesabı oluşturmanız istenir.
  4. Hizmet hesabı adı alanına açıklayıcı bir ad girin.
  5. Daha sonra kullanacağınız için Hizmet hesabı kimliğini (e-posta adresine benzer) not edin.
  6. Roll'ü Hizmet Hesapları > Hizmet Hesabı Kullanıcısı olarak ayarlayın.
  7. Hizmet hesabını oluşturma işlemini tamamlamak için Bitti'yi tıklayın.
  8. Oluşturduğunuz hizmet hesabının e-posta adresini tıklayın.
  9. **Anahtarlar**'ı tıklayın.
  10. **Anahtar ekle**'yi ve ardından **Yeni anahtar oluştur**'u tıklayın.
  11. **Anahtar türü** için **JSON**'u seçin.
  12. Oluştur'u tıklayın. Özel anahtar bilgisayarınıza indirilir.
  13. **Kapat**'ı tıklayın.
  14. Dosyayı çalışma dizininize taşıyın ve service_account_key.json olarak yeniden adlandırın.
  1. El değmeden kayıt portalını açın. Oturum açmanız gerekebilir.
  2. Hizmet hesapları'nı tıklayın.
  3. Hizmet hesabını bağla'yı tıklayın.
  4. E-posta adresi'ni, oluşturduğunuz hizmet hesabının adresine ayarlayın.
  5. Hizmet hesabını sıfır dokunuşla kayıt hesabınızla kullanmak için Hizmet hesabını bağla'yı tıklayın.

3. Adım: Google istemci kitaplığını yükleyin

Pip'i kullanarak kitaplığı yüklemek için aşağıdaki komutu çalıştırın:

pip install --upgrade google-api-python-client

Farklı yükleme seçenekleri için kitaplığın yükleme sayfasına göz atın.

4. adım: Örneği ayarlayın

Çalışma dizininizde quickstart.py adlı bir dosya oluşturun. Aşağıdaki kodu kopyalayıp dosyayı kaydedin. PARTNER_ID değerine (uygulamanın içe aktarma işlemlerinden sonraki ilk satırı) kendi satıcı iş ortağı kimliğinizi ekleyin.

#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""Zero-touch enrollment reseller quickstart.

This script forms the quickstart introduction to the zero-touch enrollemnt
reseller API. To learn more, visit https://developer.google.com/zero-touch
"""

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

# TODO: replace this with your partner reseller ID.
PARTNER_ID = '11036885';

# A single auth scope is used for the zero-touch enrollment customer API.
SCOPES = ['https://www.googleapis.com/auth/androidworkprovisioning']
SERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json'

def get_credential():
  """Creates a Credential object with the correct OAuth2 authorization.

  Creates a Credential object with the correct OAuth2 authorization
  for the service account that calls the reseller API. The service
  endpoint calls this method when setting up a new service instance.

  Returns:
    Credential, the user's credential.
  """
  credential = ServiceAccountCredentials.from_json_keyfile_name(
      SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES)
  return credential


def get_service():
  """Creates a service endpoint for the zero-touch enrollment reseller API.

  Builds and returns an authorized API client service for v1 of the API. Use
  the service endpoint to call the API methods.

  Returns:
    A service Resource object with methods for interacting with the service.
  """
  http_auth = get_credential().authorize(Http())
  service = build('androiddeviceprovisioning', 'v1', http=http_auth)
  return service


def main():
  """Runs the zero-touch enrollment quickstart app.
  """
  # Create a zero-touch enrollment API service endpoint.
  service = get_service()

  # Send an API request to list all our customers.
  response = service.partners().customers().list(partnerId=PARTNER_ID).execute()

  # Print out the details of each customer.
  if 'customers' in response:
    for customer in response['customers']:
      print 'Name:{0}  ID:{1}'.format(
          customer['companyName'], customer['companyId'])
  else:
    print 'No customers found'


if __name__ == '__main__':
  main()

İş Ortağı Kimliği

API çağrılarında genellikle bayi iş ortağı kimliğiniz bağımsız değişken olarak kullanılır. El değmeden kayıt portalında iş ortağı kimliğinizi bulmak için aşağıdaki adımları uygulayın:

  1. Portalı açın. Oturum açmanız gerekebilir.
  2. Hizmet hesapları'nı tıklayın.
  3. Bayi kimliğiniz satırından iş ortağı kimlik numaranızı kopyalayın.

5. Adım: Örneği çalıştırın

Dosyadaki komut dosyasını çalıştırmak için işletim sisteminizin yardım sayfasını kullanın. UNIX ve Mac bilgisayarlarda terminalinizde aşağıdaki komutu çalıştırın:

python quickstart.py

API yanıtlarını yazdırma

API'yi denediğinizde yanıtları incelemeyi kolaylaştırmak için JSON yanıt verilerini biçimlendirin. Aşağıdaki snippet'te, JSON modülünü kullanarak Python'da bunu nasıl yapabileceğiniz gösterilmektedir:

from json import dumps

# ...

results = provisioning.partners().devices().claimAsync(partnerId=MY_PARTNER_ID,
 body={'claims':new_claims}).execute()
# Print formatted JSON response
print dumps(results, indent=4, sort_keys=True)

Sorun giderme

Hızlı başlangıçla ilgili nelerin yanlış gittiğini bize bildirin. Sorunu düzeltmek için gerekeni yapacağız. El değmeden kayıt özelliğinin, API çağrılarını yetkilendirmek için hizmet hesaplarını nasıl kullandığını öğrenmek için Yetkilendirme bölümünü okuyun.

Daha fazla bilgi