طلب المزامنة

HTTP

توفّر واجهة برمجة التطبيقات Home Graph API نقطة نهاية 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. إليك مثال على كيفية تقديم الطلب في سطر الأوامر باستخدام 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

يوفّر برنامج Node.js في Google APIs روابط لواجهة برمجة التطبيقات Home Graph API.

1. عليك إعداد خدمة google.homegraph باستخدام بيانات الاعتماد التلقائية للتطبيق.
2. يمكنك استدعاء الطريقة requestSync باستخدام RequestSyncDeviceRequest. تعرض هذه السياسة Promise مع RequestSyncDeviceResponse فارغ.

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

توفّر مكتبة برامج HomeGraph API للغة Java روابط إلى Home Graph API.

1. عليك إعداد HomeGraphApiService باستخدام بيانات الاعتماد التلقائية للتطبيق.
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);