Questo evento supporta le notifiche aggiornabili. Le notifiche delle app esistenti create da questo evento possono essere aggiornate utilizzando i contenuti di un evento successivo con lo stesso eventThreadId.
Nest Doorbell (a batteria)Nest Doorbell (con cavo)Un ID assegnato agli eventi che si verificano nell'ambito di una singola sessione di
eventi correlati. Può essere utilizzato per consolidare gli eventi.
Utilizzalo per associare questo evento all'evento ClipPreview correlato del tratto CameraClipPreview.
Un oggetto che indica le risorse che potrebbero avere aggiornamenti simili a questo evento. La risorsa dell'evento stesso (dall'oggetto resourceUpdate) sarà sempre presente in questo oggetto.
object
Per saperne di più sui diversi tipi di eventi e sul loro funzionamento, consulta la sezione Eventi.
Errori
Per questo attributo potrebbero essere restituiti i seguenti codici di errore:
Messaggio di errore
RPC
Risoluzione dei problemi
L'immagine della videocamera non è più disponibile per il download.
DEADLINE_EXCEEDED
Le immagini degli eventi scadono 30 secondi dopo la pubblicazione dell'evento. Assicurati di scaricare l'immagine prima della scadenza.
L'ID evento non appartiene alla videocamera.
FAILED_PRECONDITION
Utilizza il eventID corretto restituito dall'evento della videocamera.
[null,null,["Ultimo aggiornamento 2025-09-01 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eCameraMotion\u003c/code\u003e trait applies to Nest devices that detect motion and triggers a \u003ccode\u003eMotion\u003c/code\u003e event when motion is detected.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMotion\u003c/code\u003e event provides an \u003ccode\u003eeventSessionId\u003c/code\u003e for correlating related events and an \u003ccode\u003eeventId\u003c/code\u003e for fetching an image associated with the event.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eMotion\u003c/code\u003e events are updateable, meaning initial notifications can be updated with subsequent event information within the same \u003ccode\u003eeventThreadId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the \u003ccode\u003eGenerateImage\u003c/code\u003e command with the \u003ccode\u003eeventId\u003c/code\u003e to download a snapshot from the camera related to the motion event.\u003c/p\u003e\n"],["\u003cp\u003eEvent images expire after 30 seconds, and using incorrect event IDs can lead to errors.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nCameraMotion Schema\n\n[Nest Cam (legacy)](/nest/device-access/api/camera) [Nest Cam (outdoor or indoor, battery)](/nest/device-access/api/camera-battery) [Nest Cam with floodlight](/nest/device-access/api/camera-floodlight) [Nest Cam (indoor, wired)](/nest/device-access/api/camera-wired) [Nest Hub Max](/nest/device-access/api/display) [Nest Doorbell (legacy)](/nest/device-access/api/doorbell) [Nest Doorbell (battery)](/nest/device-access/api/doorbell-battery) [Nest Doorbell (wired)](/nest/device-access/api/doorbell-wired)\n\n`sdm.devices.traits.CameraMotion`\n\nThis trait belongs to any device that supports motion detection events.\n\n\u003cbr /\u003e\n\nFields\n\n\nThere are no fields available for this trait.\n\n\u003cbr /\u003e\n\nCommands\n\nThere are no commands available for this trait.\n\nEvents\n\n\u003cbr /\u003e\n\nMotion [Updateable](/nest/device-access/api/events#updateable_notifications)\n\nMotion has been detected by the camera.\n\nThis event supports updateable notifications. Existing app notifications created from this event can be updated using the content of an subsequent event with the same `eventThreadId`.\n\nMotion event \n\nPayload \n\n {\n \"eventId\" : \"5305ed8b-eaf8-4308-b799-7c5ed37782f8\",\n \"timestamp\" : \"2019-01-01T00:00:01Z\",\n \"resourceUpdate\" : {\n \"name\" : \"enterprises/project-id/devices/device-id\",\n \"events\" : {\n \"sdm.devices.events.CameraMotion.Motion\" : {\n \"eventSessionId\" : \"CjY5Y3VKaTZwR3o4Y19YbTVfMF...\",\n \"eventId\" : \"f7fiA51XHqd40zOFpkLAZfQJBF...\",\n }\n }\n }\n \"userId\" : \"AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi\",\n \"eventThreadId\" : \"d67cd3f7-86a7-425e-8bb3-462f92ec9f59\",\n \"eventThreadState\" : \"STARTED\",\n \"resourceGroup\" : [\n \"enterprises/project-id/devices/device-id\"\n ]\n }\n\nMotion event fields\n\n| Field | Description | Data Type |\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|\n| `eventSessionId` | [Nest Doorbell (battery)](/nest/device-access/api/doorbell-battery) [Nest Doorbell (wired)](/nest/device-access/api/doorbell-wired) An ID given to events occurring as part of a single session of related events. May be used for consolidating events. Use it to associate this event with the related [ClipPreview](/nest/device-access/traits/device/camera-clip-preview#clippreview) event of the CameraClipPreview trait. | `string` Example: \"CjY5Y3VKaTZwR3o4Y19YbTVfMF...\" |\n| `eventId` | [Nest Cam (legacy)](/nest/device-access/api/camera) [Nest Hub Max](/nest/device-access/api/display) [Nest Doorbell (legacy)](/nest/device-access/api/doorbell) An ID associated with the event. Use it with the [GenerateImage command](/nest/device-access/traits/device/camera-event-image#generateimage) to download the camera image related to this event. | `string` Example: \"f7fiA51XHqd40zOFpkLAZfQJBF...\" |\n\nEvent payload fields\n\n| Field | Description | Data Type |\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|\n| `eventId` | The unique identifier for the event. | `string` Example: \"5305ed8b-eaf8-4308-b799-7c5ed37782f8\" |\n| `timestamp` | The time when the event occurred. | `string` Example: \"2019-01-01T00:00:01Z\" |\n| `resourceUpdate` | An object that details information about the resource update. | `object` |\n| `userId` | A unique, obfuscated identifier that represents the user. | `string` Example: \"AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi\" |\n| `eventThreadId` | [Updateable](/nest/device-access/api/events#updateable_notifications) The unique identifier for the event thread. | `string` Example: \"d67cd3f7-86a7-425e-8bb3-462f92ec9f59\" |\n| `eventThreadState` | [Updateable](/nest/device-access/api/events#updateable_notifications) The state of the event thread. | `string` Values: \"STARTED\", \"UPDATED\", \"ENDED\" |\n| `resourceGroup` | An object that indicates resources that might have similar updates to this event. The resource of the event itself (from the `resourceUpdate` object) will always be present in this object. | `object` |\n\nSee [Events](/nest/device-access/api/events) for more information on the different\ntypes of events and how they work.\n\n\u003cbr /\u003e\n\n\nErrors\n\nThe following error code(s) may be returned in relation to this trait:\n\n| Error Message | RPC | Troubleshooting |\n|---------------------------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------------|\n| Camera image is no longer available for download. | `DEADLINE_EXCEEDED` | Event images expire 30 seconds after the event is published. Make sure to download the image prior to expiration. |\n| Event id does not belong to the camera. | `FAILED_PRECONDITION` | Use the correct `eventID` returned by the camera event. |\n\nSee the [API Error Code Reference](/nest/device-access/reference/errors/api) for\nthe full list of API error codes.\n\n\u003cbr /\u003e"]]
