Method: devices.create

یک دستگاه محیطی در حساب Google Photos کاربر ایجاد می کند.

اگر دستگاهی با requestId ارائه شده از قبل وجود داشته باشد، یک خطای ALREADY_EXISTS برگردانده می شود. برای کمک به جلوگیری از دستگاه های تکراری، موارد زیر را انجام دهید:

  • اگر deviceId دستگاه موجود را می‌شناسید، با devices.get تماس بگیرید تا آن را بازیابی کنید.
  • اگر deviceId نمی‌دانید، قبل از امتحان مجدد این روش، با requestId با devices.delete تماس بگیرید تا دستگاه یتیم حذف شود.

شما می توانید تا 100 دستگاه برای هر کاربر از برنامه خود ایجاد کنید. اگر از حد مجاز فراتر رفت، یک خطای RESOURCE_EXHAUSTED برگردانده می شود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

پارامترها
requestId

string

اختیاری. یک شناسه منحصر به فرد ارائه شده توسط مشتری برای این درخواست. این برای کاهش تکرار منابع در صورت خرابی شبکه استفاده می شود.

این شناسه باید فرمت یک رشته UUID (نسخه 4) داشته باشد و شرایط زیر را رعایت کند:

  • نباید حاوی هیچ گونه اطلاعات شناسایی حساس در مورد کاربر باشد.
  • باید شامل 32 نویسه هگزا دسیمال باشد که به پنج گروه جدا شده با خط تیره، با قالب "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (یا 8-4-4-4-12) تقسیم شده اند.

درخواست بدن

بدنه درخواست شامل یک نمونه از AmbientDevice است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه تازه ایجاد شده از AmbientDevice است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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