The Cloud IoT Core API has two sets of REST resources:
cloudiot methods facilitate device manager tasks: creating and managing registries and devices, updating device configuration, and getting device state.
projects.locations.registries: Create, get, list, patch, and delete registries, and manage policies and permissions.
projects.locations.registries.devices: Create, get, list, patch, and delete devices, and modify device configurations.
projects.locations.registries.devices.configVersions: List device configurations.
projects.locations.registries.devices.states: List device states.
cloudiotdevice methods facilitate device communication over the HTTP bridge. Use these methods to get device configuration, publish device telemetry, and set device state.
projects.locations.registries.devices.getConfig: Get the configuration of a device from Cloud IoT Core (see the description of the
localVersionparameter for details about which configuration is returned).
projects.locations.registries.devices.publishEvent: Publish a device telemetry event.
projects.locations.registries.devices.setState: Report the state of a device to Cloud IoT Core.
The API reference documentation is organized by resource. Make sure to review the documentation for both sets of resources when building clients and trying out commands.
The current version of the Cloud IoT Core API is v1.
Cloud IoT Core also runs a managed broker that listens to
mqtt.googleapis.com:443. This endpoint does not offer a REST API, but it supports standard MQTT operations. For more information, see MQTT server and the MQTT specification.