Method: devices.create

Создает окружающее устройство в аккаунте Google Фото пользователя.

Если устройство с предоставленным requestId уже существует, возвращается ошибка ALREADY_EXISTS . Чтобы предотвратить дублирование устройств, выполните следующие действия:

  • Если вы знаете deviceId существующего устройства, вызовите devices.get , чтобы получить его.
  • Если вы не знаете deviceId , вызовите devices.delete с requestId , чтобы удалить потерянное устройство, прежде чем повторять этот метод.

Вы можете создать до 100 устройств на пользователя вашего приложения. Если этот лимит превышен, возвращается ошибка RESOURCE_EXHAUSTED .

HTTP-запрос

POST https://photosambient.googleapis.com/v1/devices

URL-адрес использует синтаксис gRPC Transcoding .

Параметры запроса

Параметры
requestId

string

Необязательно. Уникальный идентификатор, предоставленный клиентом для этого запроса. Используется для предотвращения дублирования ресурсов в случае сбоя сети.

Этот идентификатор должен иметь формат строки UUID (версии 4) и соответствовать следующим требованиям:

  • Не должно содержать никакой конфиденциальной идентифицирующей информации о пользователе.
  • Должен содержать 32 шестнадцатеричных символа, разделенных на пять групп, разделенных дефисами, в формате «xxxxxxxx-xxxx-xxxx-xxxxxx-xxxxxxxxxxxx» (или 8-4-4-4-12).

Текст запроса

Тело запроса содержит экземпляр AmbientDevice .

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр AmbientDevice .

Области действия авторизации

Требуется следующая область действия OAuth:

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