Method: devices.delete

  • This API endpoint allows you to delete a specified device from a user's Google Photos account using its unique device ID.

  • A NOT_FOUND error occurs if the specified device does not exist or if the user does not own the device.

  • The HTTP request utilizes a DELETE method to the URL: https://photosambient.googleapis.com/v1/devices/{deviceId}.

  • The deviceId parameter, a unique string identifier, is required and can be replaced by the requestId used in the initial devices.create request.

  • Both the request body and response body are empty, with a successful deletion resulting in an empty response.

Removes the specified device from to the user's Google Photos account.

A NOT_FOUND error is returned if the device does not exist or is not owned by the user.

An empty response indicates successful deletion.

HTTP request

DELETE https://photosambient.googleapis.com/v1/devices/{deviceId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
deviceId

string

Required. The unique unique identifier for this device, as returned in the devices.create response.

If the deviceId is lost or unknown, clients may provide the requestId used in the devices.create request that created this device. This is useful for removing orphaned devices or preventing accidental duplicates in the user's Google Photos account.

Request body

The request body must be empty.

Response body

If successful, the response body is an empty JSON object.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/photosambient.mediaitems