Minta Sinkronisasi

Request Sync memicu permintaan SYNC ke fulfillment Anda untuk setiap pengguna Google yang memiliki perangkat dengan agentUserId yang ditentukan dan terkait dengan perangkat tersebut (yang Anda kirimkan dalam permintaan SYNC asli). Hal ini memungkinkan Anda memperbarui perangkat pengguna tanpa membatalkan tautan dan menautkan kembali akun mereka. Semua pengguna yang ditautkan ke ID ini akan menerima permintaan SYNC.

Anda harus memicu permintaan SYNC:

• Jika pengguna menambahkan perangkat baru.
• Jika pengguna menghapus perangkat yang ada.
• Jika pengguna mengganti nama perangkat yang ada.
• Jika Anda menerapkan jenis perangkat, karakteristik, atau menambahkan fitur perangkat baru.

Mulai

Untuk menerapkan Request Sync, ikuti langkah-langkah berikut:

• Mengaktifkan Google HomeGraph API
• Membuat Kunci Akun Layanan
• Memanggil API

Mengaktifkan Google HomeGraph API

1. Di Google Cloud Console, buka halaman HomeGraph API.

   Buka halaman HomeGraph API
2. Pilih project yang cocok dengan ID project smart home Anda.
3. Klik ENABLE.

Membuat Kunci Akun Layanan

Ikuti petunjuk berikut untuk membuat kunci akun layanan dari Google Cloud Console:

1. Di Google Cloud Console, buka halaman Akun layanan.

   Buka halaman Akun Layanan.

   Anda mungkin perlu memilih project sebelum diarahkan ke halaman Akun Layanan.

2. Klik addBuat akun layanan.

3. Di kolom Nama akun layanan, masukkan nama.

4. Di kolom ID akun layanan, masukkan ID.

5. Di kolom Deskripsi akun layanan, masukkan deskripsi.

6. Klik Buat dan lanjutkan.

7. Dari dropdown Peran, pilih Akun Layanan > Pembuat Token Identitas OpenID Connect Akun Layanan.

8. Klik Lanjutkan.

9. Klik Selesai.

10. Pilih akun layanan yang baru saja Anda buat dari daftar akun layanan dan pilih Kelola kunci dari menu more_vert Tindakan.

11. Pilih Tambahkan kunci > Buat kunci baru.

12. Untuk Jenis kunci, pilih opsi JSON.

13. Klik Buat. File JSON yang berisi kunci Anda akan didownload ke komputer Anda.

Memanggil API

const homegraphClient = homegraph({
  version: 'v1',
  auth: new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/homegraph'
  })
});

const res = await homegraphClient.devices.requestSync({
  requestBody: {
    agentUserId: 'PLACEHOLDER-USER-ID',
    async: false
  }
});
    

// Get Application Default credentials.
GoogleCredentials credentials =
    GoogleCredentials.getApplicationDefault()
        .createScoped(List.of("https://www.googleapis.com/auth/homegraph"));

// Create Home Graph service client.
HomeGraphService homegraphService =
    new HomeGraphService.Builder(
            GoogleNetHttpTransport.newTrustedTransport(),
            GsonFactory.getDefaultInstance(),
            new HttpCredentialsAdapter(credentials))
        .setApplicationName("HomeGraphExample/1.0")
        .build();

// Request sync.
RequestSyncDevicesRequest request =
    new RequestSyncDevicesRequest().setAgentUserId("PLACEHOLDER-USER-ID").setAsync(false);
homegraphService.devices().requestSync(request);
    

Respons error

Anda mungkin menerima salah satu respons error berikut saat memanggil Request Sync. Respons ini berbentuk kode status HTTP.

• 400 Bad Request - Server tidak dapat memproses permintaan yang dikirim oleh klien karena sintaksis tidak valid. Penyebab umumnya mencakup JSON yang tidak lengkap atau menggunakan null dan bukan "" untuk nilai string.
• 403 Forbidden - Server tidak dapat memproses permintaan untuk agentUserId yang diberikan karena error saat memperbarui token. Pastikan endpoint OAuth Anda merespons permintaan token refresh dengan benar dan periksa status penautan akun pengguna.
• 404 Not Found - Sumber daya yang diminta tidak dapat ditemukan, tetapi mungkin tersedia pada masa mendatang. Biasanya, hal ini berarti akun pengguna tidak ditautkan dengan Google atau kami menerima agentUserId yang tidak valid. Pastikan agentUserId cocok dengan nilai yang diberikan dalam respons SYNC Anda, dan Anda menangani intent DISCONNECT dengan benar.
• 429 Too Many Requests - Jumlah maksimum permintaan sinkronisasi serentak telah terlampaui untuk agentUserId yang diberikan. Pemanggil hanya dapat mengeluarkan satu permintaan sinkronisasi serentak kecuali jika flag async ditetapkan ke benar (true).