API overview

The Cloud IoT Core API has two sets of REST resources: cloudiot and cloudiotdevice.

cloudiot

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

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 localVersion parameter 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.

API documentation

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.

• cloudiot
• cloudiotdevice

API version

The current version of the Cloud IoT Core API is v1.

Note: Version v1beta1 of cloudiotdevice is deprecated.

MQTT broker

Cloud IoT Core also runs a managed broker that listens to mqtt.googleapis.com:8883 and 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.