REST API ile Cihazları Manuel Olarak Kaydetme

Hızlı geliştirme için Google Asistan SDK'sı ile sağlanan kayıt aracını kullanarak bir cihaz modelini ve örneğini hızlı bir şekilde kaydedebilir veya güncelleyebilirsiniz.

Bu aracı kullanmak istemiyorsanız bir JSON dosyası ve REST API kullanarak bir cihazı manuel olarak kaydedebilir veya güncelleyebilirsiniz. Bunu herhangi bir bilgisayarda yapabilirsiniz. Önce bir erişim jetonu alın, ardından uygun bölüme geçin.

Erişim jetonu alma

  1. Yetkilendirme aracının güncel olduğundan emin olun: 

    python -m pip install --upgrade google-auth-oauthlib[tool]

  2. Yeni bir cihaz modeli kaydetmek için kimlik bilgilerini alın. Önceki bir adımı. 

    google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
      --headless --client-secrets /path/to/client_secret_client-id.json

    Terminalde bir URL gösteriliyor olmalıdır: 

    Please visit this URL to authorize this application: https://...

  3. URL'yi kopyalayıp bir tarayıcıya yapıştırın (bu, geliştirme makinenizde veya başka bir makinede yapılabilir). Onayladıktan sonra tarayıcınızda "4/XXXX" gibi bir kod görünür. Bu kodu kopyalayıp terminale yapıştırın:

    Enter the authorization code:

    Yetkilendirme başarılı olduysa aşağıdakine benzer bir JSON yanıtı görürsünüz: 

    {
   "scopes": ["https://www.googleapis.com/auth/assistant-sdk-prototype"],
   "token_uri": "https://accounts.google.com/o/oauth2/token",
   "token": "ya29.GlujBLa_kuXZ5GnGBPBe_A6NpczLcpOtglEC0wHVORnmEhHETzlSW",
   "client_id": "795595571889-6iesr9a3nkmnipbdfnqi6gehiklm2m28.apps.googleusercontent.com",
   "client_secret": "Un8_TNFnb55555auSAGasvAg",
   "refresh_token": "1/4ZMBhTR3bTYWVEMatYWLOxW755555hlQXZI5uC02F2U"
 }

    Bunun yerine UNAUTHENTICATED ifadesini görüyorsanız geçersiz bir kod girilmiş demektir. Kodun tamamını kopyalayıp yapıştırarak tekrar deneyin.

  4. JSON yanıtında token ifadesini bulun. Bu erişim jetonunu (çift tırnak işareti olmadan) bir ortam değişkenine kopyalayın:

    ACCESSTOKEN=access-token

Cihaz modeli işlemleri

Cihaz modelini tanımlayın ve kaydedin

  1. Bir dosya oluşturun (ör. device_model.json) cihaz modelinizin özelliklerini açıklayın. Daha fazla bilgi için cihaz modeli JSON referansına bakın.

  2. Aşağıdaki yöntemlerden birini kullanarak cihaz modelinizi kaydedin. Cihaz modeliyle ilişkili project_id değerini aşağıdaki URL'lerde değiştirmeyi unutmayın.

    • Aşağıdaki komutu kullanın:

      curl -s -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/

    • Aşağıdaki özelliklere sahip bir HTTPS isteği gönderin:

    Her iki yöntemde de sunucu, gönderdiğiniz cihaz modeli JSON dosyasının bir kopyasını döndürmelidir. Model sunucuda zaten mevcutsa ALREADY_EXISTS hatası alırsınız.

Cihaz modeli alın

Aşağıdaki yöntemlerden birini kullanarak bir cihaz modeli alın. Cihazınızın modeliyle ilişkilendirilmiş project_id ve device_model_id değerlerini aşağıdaki URL'lerde değiştirmeyi unutmayın.

Cihaz modellerini listeleme

Aşağıdaki yöntemlerden birini kullanarak belirli bir proje için cihaz modellerinizin tümünü listeleyin. Cihaz modellerinizle ilişkilendirilmiş project_id değerini aşağıdaki URL'lerde değiştirmeyi unutmayın.

Cihaz modelini güncelleyin

Aşağıdaki yöntemlerden birini kullanarak cihaz modelini güncelleyin. Cihazınızın modeliyle ilişkilendirilmiş project_id ve device_model_id değerlerini değiştirmeyi unutmayın.

Her iki yöntemde de sunucu, gönderdiğiniz güncellenmiş cihaz modeli JSON dosyasının bir kopyasını döndürecektir.

Cihaz modelini silme

Aşağıdaki yöntemlerden birini kullanarak bir cihaz modelini silin. Cihazınızın modeliyle ilişkilendirilmiş project_id ve device_model_id değerlerini aşağıdaki URL'lerde değiştirmeyi unutmayın.

Cihaz örneği işlemleri

Cihaz örneği tanımlayın ve kaydedin

  1. Bir dosya oluşturun (ör. test_device.json) seçebilirsiniz. Daha fazla bilgi için cihaz örneği JSON referansına bakın.

  2. Aşağıdaki yöntemlerden birini kullanarak cihazınızı kaydedin. Cihaz modeliyle ilişkili project_id değerini aşağıdaki URL'lerde değiştirmeyi unutmayın.

    • Aşağıdaki komutu kullanın:

      curl -s -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" -d @test_device.json \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/

    • Aşağıdaki özelliklere sahip bir HTTPS isteği gönderin:

    Her iki yöntemde de sunucu, gönderdiğiniz cihaz örneği JSON dosyasının bir kopyasını döndürmelidir. Örnek zaten sunucuda mevcutsa ALREADY_EXISTS hatası alırsınız.

Cihaz örneği alma

Aşağıdaki yöntemlerden birini kullanarak cihaz örneğinizi alın. Cihaz modeliyle ve cihazla id ilişkili olan project_id değerlerini aşağıdaki URL'lerde değiştirmeyi unutmayın.

Cihaz örneklerini listeleme

Aşağıdaki yöntemlerden birini kullanarak belirli bir proje için tüm cihaz örneklerinizi listeleyin. Cihaz örnekleriyle ilişkili project_id değerini aşağıdaki URL'lerde değiştirmeyi unutmayın.

  • Aşağıdaki komutu kullanın:

    curl -s -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/

  • Aşağıdaki özelliklere sahip bir HTTPS isteği gönderin:

Cihaz örneğini silme

Aşağıdaki yöntemlerden birini kullanarak cihaz örneğinizi silin. Cihaz modeliyle ve cihazla id ilişkili olan project_id değerlerini aşağıdaki URL'lerde değiştirmeyi unutmayın.