보고서 상태

HTTP

Home Graph는 HTTP 엔드포인트를 제공합니다.

1. 다운로드한 서비스 계정 JSON 파일을 사용하여 JSON 웹 토큰 (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 요청 샘플입니다.

{
  "requestId": "123ABC",
  "agentUserId": "user-123",
  "payload": {
    "devices": {
      "states": {
        "light-123": {
          "on": true
        }
      }
    }
  }
}

4. HTTP POST 요청의 보고서 상태, 알림 JSON, 토큰을 Google Home 그래프 엔드포인트에 결합합니다. 다음은 curl를 테스트로 사용하여 명령줄에서 요청하는 방법을 보여주는 예입니다.

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

gRPC

Home Graph는 요청 시 사용할 수 있는 gRPC 엔드포인트를

1. Home Graph API의 프로토콜 버퍼 서비스 정의를 확인합니다.
2. gRPC 개발자 문서에 따라 지원되는 언어 중 하나로 클라이언트 스텁을 생성합니다.
3. ReportStateAndNotification 메서드를 호출합니다.

Node.js

Google API Node.js 클라이언트는 Home Graph API에 바인딩을 제공합니다.

1. 애플리케이션 기본 사용자 인증 정보를 사용하여 google.homegraph 서비스를 초기화합니다.
2. ReportStateAndNotificationRequest를 사용하여 reportStateAndNotification 메서드를 호출합니다. 이 메서드는 ReportStateAndNotificationResponse와 함께 Promise를 반환합니다.

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

const res = await homegraphClient.devices.reportStateAndNotification({
  requestBody: {
    agentUserId: 'PLACEHOLDER-USER-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        states: {
          "PLACEHOLDER-DEVICE-ID": {
            on: true
          }
        }
      }
    }
  }
});
    

Java

Java용 HomeGraph API 클라이언트 라이브러리는 Home Graph API의 결합을 제공합니다.

1. 애플리케이션 기본 사용자 인증 정보를 사용하여 HomeGraphApiService를 초기화합니다.
2. ReportStateAndNotificationRequest를 사용하여 reportStateAndNotification 메서드를 호출합니다. 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();

  // Build device state payload.
  Map<?, ?> states = Map.of("on", true);

  // Report device state.
  ReportStateAndNotificationRequest request =
      new ReportStateAndNotificationRequest()
          .setRequestId("PLACEHOLDER-REQUEST-ID")
          .setAgentUserId("PLACEHOLDER-USER-ID")
          .setPayload(
              new StateAndNotificationPayload()
                  .setDevices(
                      new ReportStateAndNotificationDevice()
                          .setStates(Map.of("PLACEHOLDER-DEVICE-ID", states))));
  homegraphService.devices().reportStateAndNotification(request);
}