Method: devices.create

Tạo một thiết bị xung quanh trong tài khoản Google Photos của người dùng.

Nếu đã có một thiết bị có requestId được cung cấp, thì lỗi ALREADY_EXISTS sẽ được trả về. Để giúp ngăn chặn thiết bị trùng lặp, hãy làm như sau:

  • Nếu bạn biết deviceId của thiết bị hiện có, hãy gọi devices.get để truy xuất thiết bị đó.
  • Nếu bạn không biết deviceId, hãy gọi devices.delete bằng requestId để xoá thiết bị không có chủ sở hữu trước khi thử lại phương thức này.

Bạn có thể tạo tối đa 100 thiết bị cho mỗi người dùng ứng dụng. Nếu vượt quá giới hạn đó, hệ thống sẽ trả về lỗi RESOURCE_EXHAUSTED.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
requestId

string

Không bắt buộc. Giá trị nhận dạng duy nhất do ứng dụng khách cung cấp cho yêu cầu này. Phương thức này dùng để giảm thiểu tình trạng trùng lặp tài nguyên trong trường hợp xảy ra lỗi mạng.

Mã nhận dạng này phải có định dạng chuỗi UUID (phiên bản 4) và tuân thủ các yêu cầu sau:

  • Không được chứa bất kỳ thông tin nhận dạng nhạy cảm nào về người dùng.
  • Phải chứa 32 ký tự hệ thập lục phân được chia thành 5 nhóm, phân tách nhau bằng dấu gạch nối, theo định dạng "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (hoặc 8-4-4-4-12).

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của AmbientDevice.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể AmbientDevice mới tạo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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