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

Bu hızlı başlangıç kılavuzundaki adımları uygulayarak yaklaşık 10 dakikada sıfır dokunuşla kayıt bayisi API'sine istek gönderen basit bir Python komut satırı uygulaması oluşturabilirsiniz.

Ön koşullar

Bu hızlı başlangıç kılavuzunu çalıştırmak için şunlara ihtiyacınız vardır:

  • El değmeden kayıt bayinizin üyesi olan bir Google Hesabı hesap. 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ısına erişim.

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

  1. Bunu kullanın sihirbazı kullanarak Google Developers Console'da proje oluşturabilir veya seçebilirsiniz ve API'yi otomatik olarak açabilir. Devam ve ardından Kimlik bilgilerine git'i tıklayın ziyaret edin.
  2. Hangi verilere erişeceksiniz? alanını Uygulama verileri olarak ayarlayın.
  3. İleri'yi tıklayın. Hizmet oluşturmanız istenecektir hesap.
  4. Hizmet hesabı adı için açıklayıcı bir ad verin.
  5. Hizmet hesabı kimliğini (e-posta adresine benzer) not edin. Örneğin: sonradan kullanabilirsiniz.
  6. Rol'ü Hizmet Hesapları > Hizmet Hesabı Kullanıcısı.
  7. Hizmet hesabını oluşturmayı tamamlamak için Bitti'yi tıklayın.
  8. Oluşturduğunuz hizmet hesabının e-posta adresini tıklayın.
  9. **Tuşlar**'ı tıklayın.
  10. **Anahtar ekle**'yi, ardından **Yeni anahtar oluştur**'u tıklayın.
  11. **Anahtar türü** için **JSON**'yi seçin.
  12. Oluştur'u tıkladığınızda ö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. Hizmeti'ni tıklayın hesaplar.
  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ı el değmeden kayıt cihazınızla kullanmak için Hizmet hesabını bağla'yı tıklayın. kayıt hesabı.

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

Kitaplığı pip kullanarak yüklemek için aşağıdaki komutu çalıştırın:

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

Kütüphanenin yüklemesine bakın sayfasına gidin. seçenekleri vardır.

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

Çalışma dizininizde quickstart.py adlı bir dosya oluşturun. Kopyalama ve 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 bağımsız değişken olarak bayi iş ortağı kimliğiniz gerekir. Mevcut El değmeden kayıt portalındaki iş ortağı kimliğini öğrenmek için aşağıdaki adımları uygulayın:

  1. Portalı açın. Oturum açmanız gerekebilir.
  2. Hizmeti'ni tıklayın hesaplar.
  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 denerken yanıtları incelemeyi kolaylaştırmak için JSON dosyasını biçimlendirin yanıt verileri. Aşağıdaki snippet, JSON modülü:

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ıç kılavuzuyla ilgili sorunu bize bildirin, gerekli işlemleri yapalım. bu sorunu çözmek için. 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 şu makaleyi okuyun: Yetkilendirme.

Daha fazla bilgi