要求同步處理

HTTP

Home Graph API 提供 HTTP 端點

1. 使用下載的服務帳戶 JSON 檔案建立 JSON Web Token (JWT)。詳情請參閱「 使用服務帳戶驗證」。
2. 使用 OAuth2l 以 https://www.googleapis.com/auth/homegraph 範圍取得 OAuth 2.0 存取權杖：

oauth2l fetch --credentials service-account.json \
  --scope https://www.googleapis.com/auth/homegraph

3. 使用 agentUserId 建立 JSON 要求。以下是「要求同步處理」的 JSON 要求範例：

{
  "agentUserId": "user-123"
}

4. 將 Request Sync JSON 和 HTTP POST 要求中的權杖結合至 Google Home Graph 端點。以下範例說明如何在指令列中使用 curl 來進行測試：

curl -X POST -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d @request-body.json \
  "https://homegraph.googleapis.com/v1/devices:requestSync"

gRPC

Home Graph API 提供 gRPC 端點

1. 取得 Home Graph API 的通訊協定緩衝區服務定義。
2. 請按照 gRPC 開發人員說明文件，為其中一種支援的語言產生用戶端虛設常式。
3. 呼叫 RequestSync 方法。

Node.js

Google API Node.js 用戶端提供適用於 Home Graph API 的繫結。

1. 使用應用程式預設憑證來初始化 google.homegraph 服務。
2. 使用 RequestSyncDevicesRequest 呼叫 requestSync 方法。它會傳回包含空白 RequestSyncDevicesResponse 的 Promise。

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
  }
});
    

Java

Java 適用的 HomeGraph API 用戶端程式庫提供適用於 Home Graph API 的繫結。

1. 使用應用程式預設憑證來初始化 HomeGraphApiService。
2. 使用 RequestSyncDevicesRequest 呼叫 requestSync 方法。並傳回空白的 ReportStateAndNotificationResponse。

// 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);