Halaman ini diterjemahkan oleh Cloud Translation API.

Memberi Otorisasi pada Akun

Setelah project Google Cloud dan Akses Perangkat dibuat, Anda dapat memberikan otorisasi ke Akun Google dengan perangkat Google Nest yang didukung untuk SDM API.

Menautkan akun

Untuk melihat struktur dan perangkat, Anda harus menautkan Akun Google ke projectDevice Access menggunakan PCM. PCM memungkinkan user memberikan izin untuk mengizinkan developermengakses struktur dan data perangkatnya.

Dalam panduan ini, Anda berperan sebagai user dan developer.

Buka link berikut di browser web, dengan mengganti:

project-id dengan Device Access Project ID Anda
oauth2-client-id dengan Client ID OAuth2 dari Kredensial Google Cloud Anda

https://nestservices.google.com/partnerconnections/project-id/auth?redirect_uri=https://www.google.com&access_type=offline&prompt=consent&client_id=oauth2-client-id&response_type=code&scope=https://www.googleapis.com/auth/sdm.service

Jika baru-baru ini Anda login ke Google dengan beberapa akun, Anda mungkin akan melihat layar awal Pilih akun dengan daftar akun Google Anda. Jika ya, pilih Akun Google yang terikat dengan perangkat yang ingin Anda izinkan Device Access.
Layar Izin Google Nest adalah PCM itu sendiri. Di sini, Anda dapat memberikan izin struktur dan perangkat. Aktifkan izin untuk rumah Anda (Langkah 1) dan perangkat apa pun di rumah tersebut yang didukung oleh SDM API (Langkah 2), lalu klik Berikutnya.
Di layar Pilih akun untuk melanjutkan ke Nama Project, dengan Nama Project adalah nama project Google Cloud Anda, pilih akun Google yang ingin Anda beri otorisasi untuk SDM API. Gunakan Akun Google yang sama seperti sebelumnya.
Setelah memilih akun, Anda mungkin mendapatkan layar peringatan yang menyatakan Google belum memverifikasi aplikasi ini. Jika demikian, untuk melanjutkan, klik opsi Lanjutan, lalu klik Buka Nama Project (tidak aman). Lihat Google belum memverifikasi aplikasi ini untuk mengetahui informasi selengkapnya.
Di layar Berikan izin Nama Project, klik Izinkan untuk memberikan izin project untuk mengakses Akun Google Anda.
Di layar Konfirmasi pilihan Anda, pastikan izin yang ingin diberikan telah dicentang, lalu klik Izinkan untuk mengonfirmasi.
Anda akan dialihkan ke https://www.google.com. Kode Otorisasi ditampilkan sebagai parameter code di URL, yang harus dalam format ini:
```
https://www.google.com?code=authorization-code&scope=https://www.googleapis.com/auth/sdm.service
```
Salin kode otorisasi.

Mendapatkan token akses

Gunakan kode otorisasi untuk mengambil token akses yang dapat Anda gunakan untuk memanggil SDM API.

Buka terminal dan jalankan perintah curl berikut, dengan mengganti:
1. oauth2-client-id dan oauth2-client-secret dengan Client ID dan Secret Klien OAuth2 dari Kredensial Google Cloud Anda
2. authorization-code dengan kode yang Anda terima di langkah sebelumnya
```
curl -L -X POST 'https://www.googleapis.com/oauth2/v4/token?client_id=oauth2-client-id&client_secret=oauth2-client-secret&code=authorization-code&grant_type=authorization_code&redirect_uri=https://www.google.com'
```
Google OAuth menampilkan dua token, token akses, dan token refresh.
```
{
  "access_token": "access-token",
  "expires_in": 3599,
  "refresh_token": "refresh-token",
  "scope": "https://www.googleapis.com/auth/sdm.service",
  "token_type": "Bearer"
}
```
Salin kedua nilai ini. Token akses digunakan untuk memanggil SDM API dan token refresh digunakan untuk mendapatkan token akses baru.

Melakukan panggilan daftar perangkat

Otorisasi tidak akan selesai hingga Anda melakukan panggilan devices.list pertama dengan token akses baru. Panggilan awal ini menyelesaikan proses otorisasi dan mengaktifkan peristiwa jika Anda telah menyiapkan langganan Pub/Sub.

Gunakan curl untuk melakukan panggilan ini untuk endpoint devices:

curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer access-token'

Panggilan yang berhasil akan menampilkan daftar perangkat yang ditautkan ke project Device AccessAnda. Setiap perangkat memiliki daftar unik dari karakteristik yang tersedia:

{
  "devices": [
    {
      "name": "enterprises/project-id/devices/device-id",
      "type": "sdm.devices.types.device-type",
      "traits": { ... },
      "parentRelations": [
        {
          "parent": "enterprises/project-id/structures/structure-id/rooms/room-id",
          "displayName": "device-room-name"
        }
      ]
    }
  ]
}

Cara menggunakan token refresh

Token akses untuk SDM API hanya berlaku selama 1 jam, seperti yang tercantum dalam parameter expires_in yang ditampilkan oleh Google OAuth. Jika masa berlaku token akses Anda habis, gunakan token refresh untuk mendapatkan token baru.

Perintah ini mirip dengan perintah token akses, kecuali Anda menggunakan grant_type yang berbeda.

Buka terminal dan jalankan perintah curl berikut, dengan mengganti:
1. oauth2-client-id dan oauth2-client-secret dengan Client ID dan Secret Klien OAuth2 dari Kredensial Google Cloud Anda
2. refresh-token dengan kode yang Anda terima saat pertama kali mendapatkan token akses.
```
curl -L -X POST 'https://www.googleapis.com/oauth2/v4/token?client_id=oauth2-client-id&client_secret=oauth2-client-secret&refresh_token=refresh-token&grant_type=refresh_token'
```

Google OAuth menampilkan token akses baru.

{
  "access_token": "new-access-token",
  "expires_in": 3599,
  "scope": "https://www.googleapis.com/auth/sdm.service",
  "token_type": "Bearer"
}

Pemecahan masalah

Untuk mempelajari Google OAuth lebih lanjut, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Token refresh terus berakhir masa berlakunya

Token refresh dapat berhenti berfungsi setelah 7 hari jika client ID tidak disetujui. Hal ini adalah salah satu kemungkinan penyebabnya. Masa berlaku token 7 hari tidak terkait dengan persetujuan Komersial atau Sandbox. Akun layanan atau pengguna harus mendapatkan client ID OAuth 2.0 yang disetujui dan diproduksi untuk mendapatkan masa berlaku token yang lebih lama. Lihat Masa berlaku token refresh untuk mengetahui informasi selengkapnya.

Akses ditolak

Jika telah menyiapkan layar izin OAuth di Google Cloud dan Jenis pengguna adalah Eksternal, Anda akan mendapatkan error "Akses ditolak" jika mencoba menautkan akun dengan Akun Google yang tidak tercantum sebagai pengguna uji coba untuk aplikasi Anda. Pastikan untuk menambahkan Akun Google ke bagian Pengguna pengujian di layar izin OAuth.

Error Partner Connections Manager (PCM)

Untuk mendapatkan bantuan terkait error yang terjadi saat mengakses PCM, lihat Referensi Error Partner Connections Manager (PCM).

Google belum memverifikasi aplikasi ini

SDM API menggunakan cakupan terbatas, yang berarti bahwa setiap aplikasi yang menggunakan cakupan ini selama otorisasi akan "belum diverifikasi" kecuali jika Verifikasi OAuth API selesai. Saat menggunakan Device Access untuk penggunaan pribadi, Verifikasi OAuth API tidak diperlukan.

Anda mungkin melihat layar "Google belum memverifikasi aplikasi ini" selama proses otorisasi, yang muncul jika cakupan sdm.service tidak dikonfigurasi di layar izin OAuth di Google Cloud. Layar ini dapat diabaikan dengan mengklik opsi Lanjutan, lalu mengklik Buka Project Name (tidak aman).

Lihat Layar aplikasi yang belum terverifikasi untuk mengetahui informasi selengkapnya.

Klien tidak valid

Saat mencoba mendapatkan token akses atau token refresh, Anda akan mendapatkan error "Client tidak valid" jika Anda memberikan Secret Klien OAuth 2.0 yang salah. Pastikan nilai client_secret yang Anda gunakan dalam panggilan token akses dan refresh adalah nilai untuk Client ID OAuth 2.0 yang digunakan, seperti yang ditemukan di halaman Kredensial Google Cloud.

Permintaan tidak valid, cakupan yang diperlukan tidak ada

Setelah memberikan izin di PCM, Anda mungkin mengalami error "Permintaan tidak valid" dari "Parameter yang diperlukan tidak ada: cakupan". Pastikan nilai scope yang Anda gunakan dalam panggilan otorisasi sama dengan yang Anda tetapkan untuk Klien OAuth 2.0, seperti yang ditemukan di halaman Kredensial Google Cloud.

URI pengalihan tidak cocok

Saat melakukan otorisasi, Anda mungkin mengalami error "Redirect uri mismatch". Pastikan nilai redirect_uri yang Anda gunakan dalam panggilan otorisasi sama dengan yang Anda tetapkan untuk Klien OAuth 2.0, seperti yang ditemukan di halaman Kredensial Google Cloud.

Mengubah izin akun

Untuk mengubah izin yang diberikan ke project Device Access , atau memutuskannya sepenuhnya, buka PCM:

https://nestservices.google.com/partnerconnections

Halaman ini menampilkan semua layanan developer pihak ketiga (projectDevice Access ) yang terhubung ke akun Anda. Pilih Device Access project yang ingin Anda ubah. Gunakan layar berikutnya untuk mengubah izin sesuai keinginan.

Untuk mencabut izin tertentu saja untuk layanan yang diotorisasi, alihkan izin yang ingin dicabut, lalu klik panah kembali untuk menyimpan.

Untuk memutuskan koneksi layanan yang diotorisasi sepenuhnya, klik Batalkan tautan Akun Google Anda untuk mencabut semua izin dan token akses yang telah diberikan project untuk akun tersebut.

Jika PCM tidak menampilkan layanan yang diinginkan, Anda mungkin perlu melakukan panggilan daftar perangkat terlebih dahulu.

Referensi cepat

Gunakan referensi ini untuk menerapkan langkah-langkah dengan cepat guna memberikan otorisasi kepada user dan menautkan Akun Google mereka .

Untuk menggunakan referensi cepat ini, edit setiap variabel placeholder dalam contoh kode dengan nilai untuk integrasi spesifik Anda, lalu salin dan tempel sesuai kebutuhan:

1 PCM

Buka link berikut di browser web, dengan mengganti:

project-id dengan Device Access Project ID Anda
oauth2-client-id dengan Client ID OAuth2 dari Kredensial Google Cloud Anda

https://nestservices.google.com/partnerconnections/project-id/auth?redirect_uri=https://www.google.com&access_type=offline&prompt=consent&client_id=oauth2-client-id&response_type=code&scope=https://www.googleapis.com/auth/sdm.service

2 Kode Autentikasi

Anda akan dialihkan ke https://www.google.com. Kode Otorisasi ditampilkan sebagai parameter code di URL, yang harus dalam format ini:

https://www.google.com?code=authorization-code&scope=https://www.googleapis.com/auth/sdm.service

3 Token Akses

Gunakan kode otorisasi untuk mengambil token akses yang dapat Anda gunakan untuk memanggil SDM API.

Buka terminal dan jalankan perintah curl berikut, dengan mengganti:

oauth2-client-id dan oauth2-client-secret dengan Client ID dan Secret Klien OAuth2 dari Kredensial Google Cloud Anda
authorization-code dengan kode yang Anda terima di langkah sebelumnya

Google OAuth menampilkan dua token, token akses, dan token refresh.

Permintaan

curl -L -X POST 'https://www.googleapis.com/oauth2/v4/token?client_id=oauth2-client-id&client_secret=oauth2-client-secret&code=authorization-code&grant_type=authorization_code&redirect_uri=https://www.google.com'

Respons

{
  "access_token": "access-token",
  "expires_in": 3599,
  "refresh_token": "refresh-token",
  "scope": "https://www.googleapis.com/auth/sdm.service",
  "token_type": "Bearer"
}

4 Panggilan API

Anda harus menggunakan salah satu panggilan API yang tercantum untuk cakupan yang ditentukan guna menyelesaikan otorisasi.

sdm.service

perangkat

Lihat referensi API devices.list untuk mengetahui informasi selengkapnya.

curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer access-token'

5 Token Refresh

Buka terminal dan jalankan perintah curl berikut, dengan mengganti:

oauth2-client-id dan oauth2-client-secret dengan Client ID dan Secret Klien OAuth2 dari Kredensial Google Cloud Anda
refresh-token dengan kode yang Anda terima saat pertama kali mendapatkan token akses.

Google OAuth menampilkan token akses baru.

Permintaan

curl -L -X POST 'https://www.googleapis.com/oauth2/v4/token?client_id=oauth2-client-id&client_secret=oauth2-client-secret&refresh_token=refresh-token&grant_type=refresh_token'

Tanggapan

{
  "access_token": "new-access-token",
  "expires_in": 3599,
  "scope": "https://www.googleapis.com/auth/sdm.service",
  "token_type": "Bearer"
}