Bu hızlı başlangıç kılavuzundaki adımları uygulayın ve yaklaşık 10 dakika içinde bir hizmet hesabı kullanarak el değmeden kayıt müşteri API'sine istekte bulunan basit bir Python komut satırı uygulamanız olsun.
Ön koşullar
Bu hızlı başlangıç kılavuzunu çalıştırmak için aşağıdakilere ihtiyacınız vardır:
- El değmeden kayıt müşteri hesabına bağlı bir hizmet hesabı. Başlayın başlıklı makaleye göz atın.
- Python 3.0 veya üzeri.
- pip paket yönetimi aracı.
- İnternete ve web tarayıcısına erişim.
1. Adım: El değmeden kayıt API'sini etkinleştirin
- Google Developers Console'da proje oluşturmak veya seçmek ve API'yi otomatik olarak etkinleştirmek için bu sihirbazı kullanın. Devam'ı ve ardından Kimlik bilgilerine git'i tıklayın.
- Hangi verilere erişeceksiniz? seçeneğini Uygulama verileri olarak ayarlayın.
- İleri'yi tıklayın. Hizmet hesabı oluşturmanız istenir.
- Hizmet hesabı adı için açıklayıcı bir ad verin.
- Daha sonra kullanacağınız için Hizmet hesabı kimliğini (e-posta adresi gibi görünür) not alın.
- Rol'ü Hizmet Hesapları > Hizmet Hesabı Kullanıcısı olarak ayarlayın.
- Hizmet hesabını oluşturma işlemini 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ıklayın. Ö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: Google istemci kitaplığını yükleyin
Pip kullanarak kitaplığı yüklemek için aşağıdaki komutu çalıştırın:
pip install --upgrade google-api-python-client oauth2client
Farklı yükleme seçenekleri için kitaplığın yükleme sayfasına göz atın.
3. Adım: Örneği oluşturma
Çalışma dizininizde quickstart.py
adlı bir dosya oluşturun. Aşağıdaki kodu kopyalayın ve dosyayı kaydedin.
#!/usr/bin/env python # -*- coding: utf-8 -*- """Zero-touch enrollment quickstart sample. This script forms the quickstart introduction to the zero-touch enrollemnt customer API. To learn more, visit https://developer.google.com/zero-touch """ import sys from apiclient import discovery import httplib2 from oauth2client.service_account import ServiceAccountCredentials # A single auth scope is used for the zero-touch enrollment customer API. SCOPES = ['https://www.googleapis.com/auth/androidworkzerotouchemm'] SERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json' def get_credential(): """Creates a Credential object with the correct OAuth2 authorization. Uses the service account key stored in SERVICE_ACCOUNT_KEY_FILE. Returns: Credentials, the user's credential. """ credential = ServiceAccountCredentials.from_json_keyfile_name( SERVICE_ACCOUNT_KEY_FILE, SCOPES) if not credential or credential.invalid: print('Unable to authenticate using service account key.') sys.exit() return credential def get_service(): """Creates a service endpoint for the zero-touch enrollment 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(httplib2.Http()) return discovery.build('androiddeviceprovisioning', 'v1', http=http_auth) def main(): """Runs the zero-touch enrollment quickstart app. """ # Create a zero-touch enrollment API service endpoint. service = get_service() # Get the customer's account. Because a customer might have more # than one, limit the results to the first account found. response = service.customers().list(pageSize=1).execute() if 'customers' not in response: # No accounts found for the user. Confirm the Google Account # that authorizes the request can access the zero-touch portal. print('No zero-touch enrollment account found.') sys.exit() customer_account = response['customers'][0]['name'] # Send an API request to list all the DPCs available using the customer # account. results = service.customers().dpcs().list(parent=customer_account).execute() # Print out the details of each DPC. for dpc in results['dpcs']: # Some DPCs may not have a name, so replace with a marker. if 'dpcName' in dpc: dpcName = dpc['dpcName'] else: dpcName = "-" print('Name:{0} APK:{1}'.format(dpcName, dpc['packageName'])) if __name__ == '__main__': main()
4. Adım: Hizmet hesabı anahtarınızı ekleyin
Hizmet hesabınızı oluştururken indirdiğiniz service_account_key.json
dosyasını çalışma dizininize kopyalayın.
5. Adım: Örneği çalıştırın
Komut dosyasını dosyada çalıştırmak için işletim sisteminizin yardımını kullanın. UNIX ve Mac bilgisayarlarda, terminalinizde aşağıdaki komutu çalıştırın:
python quickstart.py
Notlar
service_account_key.json
dosyanızı kimseyle paylaşmaktan kaçının. Bu kodu kaynak kodu depolarına eklememeye dikkat edin. Hizmet hesabı gizli anahtarlarını işleme hakkında daha fazla bilgi edinebilirsiniz.