Minta Sinkronisasi

Permintaan Sinkronisasi memicu permintaan SYNC ke fulfillment Anda untuk semua pengguna Google dengan perangkat yang memiliki agentUserId yang terkait dengannya (yang Anda yang dikirim dalam permintaan SYNC asli). Hal ini memungkinkan Anda memperbarui perangkat tanpa membatalkan tautan dan menautkan ulang akun mereka. Semua pengguna yang tertaut ke ini ID akan menerima permintaan SYNC.

Anda harus memicu permintaan SYNC:

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

Mulai

Untuk menerapkan Permintaan Sinkronisasi, 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 project ID 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 Create service account key.

   Buka halaman Create Service Account Key
2. Dari daftar Service account, pilih Akun layanan baru.
3. Di kolom Nama akun layanan, masukkan nama.
4. Di kolom ID akun layanan, masukkan ID.

5. Dari daftar Role, pilih Service Accounts > Service Account Token Creator Google.

6. Untuk Jenis kunci, pilih opsi JSON.

7. Klik Buat. File JSON yang berisi kunci Anda {i>download<i} 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 umum sertakan format JSON yang salah atau gunakan null dan bukan "" untuk nilai {i>string<i}.
• 403 Forbidden - Server tidak dapat memproses permintaan untuk agentUserId yang diberikan karena terjadi error saat memperbarui token. Pastikan endpoint OAuth Anda merespons untuk memperbarui permintaan token dan memeriksa penautan akun pengguna .
• 404 Not Found - Resource yang diminta tidak mungkin ditemukan, tetapi mungkin tersedia di masa mendatang. Biasanya, ini berarti bahwa akun pengguna tidak ditautkan dengan Google atau kami menerima agentUserId. Pastikan bahwa agentUserId cocok dengan nilai yang diberikan di respons SYNC Anda, dan Anda menangani intent DISCONNECT.
• 429 Too Many Requests - Jumlah maksimum sinkronisasi serentak permintaan telah terlampaui untuk agentUserId yang diberikan. Penelepon hanya dapat mengeluarkan satu permintaan sinkronisasi serentak kecuali jika async ditetapkan ke true.