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
- 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.
- Hangi verilere erişeceksiniz? alanını Uygulama verileri olarak ayarlayın.
- İleri'yi tıklayın. Hizmet oluşturmanız istenecektir hesap.
- Hizmet hesabı adı için açıklayıcı bir ad verin.
- Hizmet hesabı kimliğini (e-posta adresine benzer) not edin. Örneğin: sonradan kullanabilirsiniz.
- Rol'ü Hizmet Hesapları > Hizmet Hesabı Kullanıcısı.
- Hizmet hesabını oluşturmayı tamamlamak için Bitti'yi tıklayın.
- Oluşturduğunuz hizmet hesabının e-posta adresini tıklayın.
- **Tuşlar**'ı tıklayın.
- **Anahtar ekle**'yi, ardından **Yeni anahtar oluştur**'u tıklayın.
- **Anahtar türü** için **JSON**'yi seçin.
- Oluştur'u tıkladığınızda özel anahtar bilgisayarınıza indirilir.
- **Kapat**'ı tıklayın.
- Dosyayı çalışma dizininize taşıyın ve
service_account_key.json
olarak yeniden adlandırın.
2. Adım: Hizmet hesabını bağlayın
- El değmeden kayıt portalını açın. Oturum açmanız gerekebilir.
- Hizmeti'ni tıklayın hesaplar.
- Hizmet hesabını bağla'yı tıklayın.
- E-posta adresi'ni, oluşturduğunuz hizmet hesabının adresine ayarlayın.
- 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:
- Portalı açın. Oturum açmanız gerekebilir.
- Hizmeti'ni tıklayın hesaplar.
- 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.