Method: devices.create

사용자의 Google 포토 계정에 화면 보호 모드 기기를 만듭니다.

제공된 requestId가 있는 기기가 이미 있는 경우 ALREADY_EXISTS 오류가 반환됩니다. 중복 기기를 방지하려면 다음 단계를 따르세요.

  • 기존 기기의 deviceId를 알고 있다면 devices.get를 호출하여 가져옵니다.
  • deviceId를 모르는 경우 이 메서드를 다시 시도하기 전에 requestId를 사용하여 devices.delete를 호출하여 고아 기기를 삭제합니다.

앱 사용자당 최대 100대의 기기를 만들 수 있습니다. 이 한도를 초과하면 RESOURCE_EXHAUSTED 오류가 반환됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
requestId

string

선택사항입니다. 이 요청에 대해 클라이언트가 제공한 고유 식별자입니다. 이는 네트워크 장애 발생 시 리소스 중복을 완화하는 데 사용됩니다.

이 ID는 UUID (버전 4) 문자열 형식이어야 하며 다음 요구사항을 충족해야 합니다.

  • 사용자에 관한 민감한 식별 정보가 포함되어서는 안 됩니다.
  • 16진수 32자리로 구성되며 하이픈으로 구분된 5개 그룹으로 나뉘고 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' (또는 8-4-4-4-12) 형식이어야 합니다.

요청 본문

요청 본문에 AmbientDevice의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 AmbientDevice의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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