בקשה לסנכרון

HTTP

ב-Home Graph API יש נקודת קצה (endpoint) מסוג HTTP

1. משתמשים בקובץ ה-JSON של חשבון השירות שהורדתם כדי ליצור אסימון אינטרנט מסוג JSON (JWT). למידע נוסף, ראו אימות באמצעות חשבון שירות.
2. משיגים אסימון גישה מסוג OAuth 2.0 עם ההיקף https://www.googleapis.com/auth/homegraph באמצעות oauth2l:

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

3. יוצרים את בקשת ה-JSON עם התג agentUserId. הנה דוגמה לבקשת JSON ל'בקשת סנכרון':

{
  "agentUserId": "user-123"
}

4. משלבים את ה-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 מספק נקודת קצה (endpoint) של gRPC

1. מורידים את ההגדרה של שירות מאגר נתונים זמני של פרוטוקולים ל-Home Graph API.
2. יש לעיין במסמכי התיעוד למפתחים בנושא gRPC כדי ליצור מודלים של לקוחות (stubs) עבור אחת מהשפות הנתמכות.
3. מפעילים את השיטה RequestSync.

Node.js

לקוח Node.js של Google APIs מספק קישורים ל-Home Graph API.

1. מפעילים את השירות google.homegraph באמצעות Application Default Credentials.
2. מפעילים את ה-method requestSync באמצעות RequestSyncDevicesRequest. היא מחזירה Promise עם RequestSyncDevicesResponse ריק.

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

ספריית הלקוח של Home Graph API ל-Java מספקת קישורים ל-Home Graph API.

1. מאתחלים את HomeGraphApiService באמצעות Application Default Credentials.
2. מפעילים את השיטה requestSync עם RequestSyncDevicesRequest. הפונקציה מחזירה ערך ריק של 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);