اعلان‌ها برای اقدامات خانه هوشمند

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 برای Report State و اعلان آمده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "ObjectDetection": {
            "priority": 0,
            "detectionTimestamp": 1534875126750,
            "objects": {
              "named": [
                "Alice"
              ],
              "unclassified": 2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

Home Graph API یک نقطه پایانی gRPC را ارائه می دهد

1. تعریف سرویس بافرهای پروتکل را برای Home Graph API دریافت کنید.
2. مستندات توسعه‌دهنده gRPC را دنبال کنید تا برای یکی از زبان‌های پشتیبانی‌شده، خرد کلاینت ایجاد کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

Google APIs Node.js Client اتصالاتی را برای Home Graph API فراهم می کند.

1. سرویس google.homegraph را با استفاده از Application Default Credentials راه اندازی کنید.
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. با 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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            ObjectDetection: {
              priority: 0,
              detectionTimestamp: 1534875126750,
              objects: {
                named: ['Alice'],
                unclassified: 2
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

HomeGraph API Client Library برای جاوا اتصالاتی را برای Home Graph API فراهم می کند.

1. HomeGraphApiService را با استفاده از Application Default Credentials راه اندازی کنید.
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. یک 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 notification payload.
Map<?, ?> notifications =
    Map.of(
        "ObjectDetection",
        Map.of(
            "priority", 0,
            "detectionTimestamp", 1534875126,
            "objects", Map.of("named", List.of("Alice"), "unclassifed", 2)));

// Send notification.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", notifications))));
homegraphService.devices().reportStateAndNotification(request);
    

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 برای Report State و اعلان آمده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "NetworkControl": {
            "priority": 0,
            "followUpResponse": {
              "status": "SUCCESS",
              "followUpToken": "PLACEHOLDER",
              "networkDownloadSpeedMbps": 23.3,
              "networkUploadSpeedMbps": 10.2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

Home Graph API یک نقطه پایانی gRPC را ارائه می دهد

1. تعریف سرویس بافرهای پروتکل را برای Home Graph API دریافت کنید.
2. مستندات توسعه‌دهنده gRPC را دنبال کنید تا برای یکی از زبان‌های پشتیبانی‌شده، خرد کلاینت ایجاد کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

Google APIs Node.js Client اتصالاتی را برای Home Graph API فراهم می کند.

1. سرویس google.homegraph را با استفاده از Application Default Credentials راه اندازی کنید.
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. با ReportStateAndNotificationResponse یک Promise برمی گرداند.

const followUpToken = executionRequest.inputs[0].payload.commands[0].execution[0].params.followUpToken;

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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            NetworkControl: {
              priority: 0,
              followUpResponse: {
                status: 'SUCCESS',
                followUpToken,
                networkDownloadSpeedMbps: 23.3,
                networkUploadSpeedMbps: 10.2,
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

HomeGraph API Client Library برای جاوا اتصالاتی را برای Home Graph API فراهم می کند.

1. HomeGraphApiService را با استفاده از Application Default Credentials راه اندازی کنید
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. یک 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();

// Extract follow-up token.
ExecuteRequest.Inputs executeInputs = (Inputs) executeRequest.getInputs()[0];
String followUpToken =
    (String)
        executeInputs
            .getPayload()
            .getCommands()[0]
            .getExecution()[0]
            .getParams()
            .get("followUpToken");

// Build device follow-up response payload.
Map<?, ?> followUpResponse =
    Map.of(
        "NetworkControl",
        Map.of(
            "priority",
            0,
            "followUpResponse",
            Map.of(
                "status",
                "SUCCESS",
                "followUpToken",
                followUpToken,
                "networkDownloadSpeedMbps",
                23.3,
                "networkUploadSpeedMbps",
                10.2)));

// Send follow-up response.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", followUpResponse))));
homegraphService.devices().reportStateAndNotification(request);
    

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 برای Report State و اعلان آمده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "ObjectDetection": {
            "priority": 0,
            "detectionTimestamp": 1534875126750,
            "objects": {
              "named": [
                "Alice"
              ],
              "unclassified": 2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

Home Graph API یک نقطه پایانی gRPC را ارائه می دهد

1. تعریف سرویس بافرهای پروتکل را برای Home Graph API دریافت کنید.
2. مستندات توسعه‌دهنده gRPC را دنبال کنید تا برای یکی از زبان‌های پشتیبانی‌شده، خرد کلاینت ایجاد کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

Google APIs Node.js Client اتصالاتی را برای Home Graph API فراهم می کند.

1. سرویس google.homegraph را با استفاده از Application Default Credentials راه اندازی کنید.
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. با 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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            ObjectDetection: {
              priority: 0,
              detectionTimestamp: 1534875126750,
              objects: {
                named: ['Alice'],
                unclassified: 2
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

HomeGraph API Client Library برای جاوا اتصالاتی را برای Home Graph API فراهم می کند.

1. HomeGraphApiService را با استفاده از Application Default Credentials راه اندازی کنید.
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. یک 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 notification payload.
Map<?, ?> notifications =
    Map.of(
        "ObjectDetection",
        Map.of(
            "priority", 0,
            "detectionTimestamp", 1534875126,
            "objects", Map.of("named", List.of("Alice"), "unclassifed", 2)));

// Send notification.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", notifications))));
homegraphService.devices().reportStateAndNotification(request);
    

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 برای Report State و اعلان آمده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "NetworkControl": {
            "priority": 0,
            "followUpResponse": {
              "status": "SUCCESS",
              "followUpToken": "PLACEHOLDER",
              "networkDownloadSpeedMbps": 23.3,
              "networkUploadSpeedMbps": 10.2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

Home Graph API یک نقطه پایانی gRPC را ارائه می دهد

1. تعریف سرویس بافرهای پروتکل را برای Home Graph API دریافت کنید.
2. مستندات توسعه‌دهنده gRPC را دنبال کنید تا برای یکی از زبان‌های پشتیبانی‌شده، خرد کلاینت ایجاد کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

Google APIs Node.js Client اتصالاتی را برای Home Graph API فراهم می کند.

1. سرویس google.homegraph را با استفاده از Application Default Credentials راه اندازی کنید.
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. با ReportStateAndNotificationResponse یک Promise برمی گرداند.

const followUpToken = executionRequest.inputs[0].payload.commands[0].execution[0].params.followUpToken;

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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            NetworkControl: {
              priority: 0,
              followUpResponse: {
                status: 'SUCCESS',
                followUpToken,
                networkDownloadSpeedMbps: 23.3,
                networkUploadSpeedMbps: 10.2,
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

HomeGraph API Client Library برای جاوا اتصالاتی را برای Home Graph API فراهم می کند.

1. HomeGraphApiService را با استفاده از Application Default Credentials راه اندازی کنید
2. روش reportStateAndNotification را با ReportStateAndNotificationRequest فراخوانی کنید. یک 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();

// Extract follow-up token.
ExecuteRequest.Inputs executeInputs = (Inputs) executeRequest.getInputs()[0];
String followUpToken =
    (String)
        executeInputs
            .getPayload()
            .getCommands()[0]
            .getExecution()[0]
            .getParams()
            .get("followUpToken");

// Build device follow-up response payload.
Map<?, ?> followUpResponse =
    Map.of(
        "NetworkControl",
        Map.of(
            "priority",
            0,
            "followUpResponse",
            Map.of(
                "status",
                "SUCCESS",
                "followUpToken",
                followUpToken,
                "networkDownloadSpeedMbps",
                23.3,
                "networkUploadSpeedMbps",
                10.2)));

// Send follow-up response.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", followUpResponse))));
homegraphService.devices().reportStateAndNotification(request);
    

HTTP

API Home Graph یک نقطه پایانی HTTP را فراهم می کند

1. برای ایجاد یک توکن وب JSON (JWT) از پرونده JSON حساب بارگیری شده استفاده کنید. برای اطلاعات بیشتر ، به تأیید اعتبار با استفاده از یک حساب خدمات مراجعه کنید.
2. با استفاده از oauth2l ، یک نشانه دسترسی OAUTH 2.0 با https://www.googleapis.com/auth/homegraph را بدست آورید:

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

3. درخواست JSON را با agentUserId ایجاد کنید. در اینجا یک نمونه درخواست JSON برای Report State و اطلاع رسانی آورده شده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "ObjectDetection": {
            "priority": 0,
            "detectionTimestamp": 1534875126750,
            "objects": {
              "named": [
                "Alice"
              ],
              "unclassified": 2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

API Home Graph یک نقطه پایانی GRPC را فراهم می کند

1. تعریف سرویس بافر پروتکل را برای API Home Graph دریافت کنید.
2. برای تولید خرد های مشتری برای یکی از زبانهای پشتیبانی شده ، مستندات توسعه دهنده GRPC را دنبال کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

مشتری Google APIS Node.js الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، سرویس google.homegraph را اولیه کنید.
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک Promise با ReportStateAndNotificationResponse را برمی گرداند.

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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            ObjectDetection: {
              priority: 0,
              detectionTimestamp: 1534875126750,
              objects: {
                named: ['Alice'],
                unclassified: 2
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

کتابخانه مشتری Homegraph API برای جاوا ، الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، HomeGraphApiService را آغاز کنید.
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک 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 notification payload.
Map<?, ?> notifications =
    Map.of(
        "ObjectDetection",
        Map.of(
            "priority", 0,
            "detectionTimestamp", 1534875126,
            "objects", Map.of("named", List.of("Alice"), "unclassifed", 2)));

// Send notification.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", notifications))));
homegraphService.devices().reportStateAndNotification(request);
    

HTTP

API Home Graph یک نقطه پایانی HTTP را فراهم می کند

1. برای ایجاد یک توکن وب JSON (JWT) از پرونده JSON حساب بارگیری شده استفاده کنید. برای اطلاعات بیشتر ، به تأیید اعتبار با استفاده از یک حساب خدمات مراجعه کنید.
2. با استفاده از oauth2l ، یک نشانه دسترسی OAUTH 2.0 با https://www.googleapis.com/auth/homegraph را بدست آورید:

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

3. درخواست JSON را با agentUserId ایجاد کنید. در اینجا یک نمونه درخواست JSON برای Report State و اطلاع رسانی آورده شده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "NetworkControl": {
            "priority": 0,
            "followUpResponse": {
              "status": "SUCCESS",
              "followUpToken": "PLACEHOLDER",
              "networkDownloadSpeedMbps": 23.3,
              "networkUploadSpeedMbps": 10.2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

API Home Graph یک نقطه پایانی GRPC را فراهم می کند

1. تعریف سرویس بافر پروتکل را برای API Home Graph دریافت کنید.
2. برای تولید خرد های مشتری برای یکی از زبانهای پشتیبانی شده ، مستندات توسعه دهنده GRPC را دنبال کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

مشتری Google APIS Node.js الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، سرویس google.homegraph را اولیه کنید.
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک Promise با ReportStateAndNotificationResponse را برمی گرداند.

const followUpToken = executionRequest.inputs[0].payload.commands[0].execution[0].params.followUpToken;

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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            NetworkControl: {
              priority: 0,
              followUpResponse: {
                status: 'SUCCESS',
                followUpToken,
                networkDownloadSpeedMbps: 23.3,
                networkUploadSpeedMbps: 10.2,
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

کتابخانه مشتری Homegraph API برای جاوا ، الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، HomeGraphApiService را آغاز کنید
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک 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();

// Extract follow-up token.
ExecuteRequest.Inputs executeInputs = (Inputs) executeRequest.getInputs()[0];
String followUpToken =
    (String)
        executeInputs
            .getPayload()
            .getCommands()[0]
            .getExecution()[0]
            .getParams()
            .get("followUpToken");

// Build device follow-up response payload.
Map<?, ?> followUpResponse =
    Map.of(
        "NetworkControl",
        Map.of(
            "priority",
            0,
            "followUpResponse",
            Map.of(
                "status",
                "SUCCESS",
                "followUpToken",
                followUpToken,
                "networkDownloadSpeedMbps",
                23.3,
                "networkUploadSpeedMbps",
                10.2)));

// Send follow-up response.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", followUpResponse))));
homegraphService.devices().reportStateAndNotification(request);
    

HTTP

API Home Graph یک نقطه پایانی HTTP را فراهم می کند

1. برای ایجاد یک توکن وب JSON (JWT) از پرونده JSON حساب بارگیری شده استفاده کنید. برای اطلاعات بیشتر ، به تأیید اعتبار با استفاده از یک حساب خدمات مراجعه کنید.
2. با استفاده از oauth2l ، یک نشانه دسترسی OAUTH 2.0 با https://www.googleapis.com/auth/homegraph را بدست آورید:

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

3. درخواست JSON را با agentUserId ایجاد کنید. در اینجا یک نمونه درخواست JSON برای Report State و اطلاع رسانی آورده شده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "ObjectDetection": {
            "priority": 0,
            "detectionTimestamp": 1534875126750,
            "objects": {
              "named": [
                "Alice"
              ],
              "unclassified": 2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

API Home Graph یک نقطه پایانی GRPC را فراهم می کند

1. تعریف سرویس بافر پروتکل را برای API Home Graph دریافت کنید.
2. برای تولید خرد های مشتری برای یکی از زبانهای پشتیبانی شده ، مستندات توسعه دهنده GRPC را دنبال کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

مشتری Google APIS Node.js الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، سرویس google.homegraph را اولیه کنید.
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک Promise با ReportStateAndNotificationResponse را برمی گرداند.

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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            ObjectDetection: {
              priority: 0,
              detectionTimestamp: 1534875126750,
              objects: {
                named: ['Alice'],
                unclassified: 2
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

کتابخانه مشتری Homegraph API برای جاوا ، الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، HomeGraphApiService را آغاز کنید.
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک 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 notification payload.
Map<?, ?> notifications =
    Map.of(
        "ObjectDetection",
        Map.of(
            "priority", 0,
            "detectionTimestamp", 1534875126,
            "objects", Map.of("named", List.of("Alice"), "unclassifed", 2)));

// Send notification.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", notifications))));
homegraphService.devices().reportStateAndNotification(request);
    

HTTP

API Home Graph یک نقطه پایانی HTTP را فراهم می کند

1. برای ایجاد یک توکن وب JSON (JWT) از پرونده JSON حساب بارگیری شده استفاده کنید. برای اطلاعات بیشتر ، به تأیید اعتبار با استفاده از یک حساب خدمات مراجعه کنید.
2. با استفاده از oauth2l ، یک نشانه دسترسی OAUTH 2.0 با https://www.googleapis.com/auth/homegraph را بدست آورید:

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

3. درخواست JSON را با agentUserId ایجاد کنید. در اینجا یک نمونه درخواست JSON برای Report State و اطلاع رسانی آورده شده است:

{
  "agentUserId": "PLACEHOLDER-USER-ID",
  "eventId": "PLACEHOLDER-EVENT-ID",
  "requestId": "PLACEHOLDER-REQUEST-ID",
  "payload": {
    "devices": {
      "notifications": {
        "PLACEHOLDER-DEVICE-ID": {
          "NetworkControl": {
            "priority": 0,
            "followUpResponse": {
              "status": "SUCCESS",
              "followUpToken": "PLACEHOLDER",
              "networkDownloadSpeedMbps": 23.3,
              "networkUploadSpeedMbps": 10.2
            }
          }
        }
      }
    }
  }
}

4. Report State و اعلان 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:reportStateAndNotification"

gRPC

API Home Graph یک نقطه پایانی GRPC را فراهم می کند

1. تعریف سرویس بافر پروتکل را برای API Home Graph دریافت کنید.
2. برای تولید خرد های مشتری برای یکی از زبانهای پشتیبانی شده ، مستندات توسعه دهنده GRPC را دنبال کنید.
3. با روش ReportStateAndNotification تماس بگیرید.

Node.js

مشتری Google APIS Node.js الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، سرویس google.homegraph را اولیه کنید.
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک Promise با ReportStateAndNotificationResponse را برمی گرداند.

const followUpToken = executionRequest.inputs[0].payload.commands[0].execution[0].params.followUpToken;

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',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            NetworkControl: {
              priority: 0,
              followUpResponse: {
                status: 'SUCCESS',
                followUpToken,
                networkDownloadSpeedMbps: 23.3,
                networkUploadSpeedMbps: 10.2,
              }
            }
          }
        }
      }
    }
  }
});
    

جاوا

کتابخانه مشتری Homegraph API برای جاوا ، الزاماتی را برای API Home Graph فراهم می کند.

1. با استفاده از اعتبار پیش فرض برنامه ، HomeGraphApiService را آغاز کنید
2. با روش reportStateAndNotification با ReportStateAndNotificationRequest تماس بگیرید. این یک 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();

// Extract follow-up token.
ExecuteRequest.Inputs executeInputs = (Inputs) executeRequest.getInputs()[0];
String followUpToken =
    (String)
        executeInputs
            .getPayload()
            .getCommands()[0]
            .getExecution()[0]
            .getParams()
            .get("followUpToken");

// Build device follow-up response payload.
Map<?, ?> followUpResponse =
    Map.of(
        "NetworkControl",
        Map.of(
            "priority",
            0,
            "followUpResponse",
            Map.of(
                "status",
                "SUCCESS",
                "followUpToken",
                followUpToken,
                "networkDownloadSpeedMbps",
                23.3,
                "networkUploadSpeedMbps",
                10.2)));

// Send follow-up response.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", followUpResponse))));
homegraphService.devices().reportStateAndNotification(request);