Method: devices.patch

اطلاعات مربوط به دستگاه مشخص شده را به روز می کند.

اگر دستگاه وجود نداشته باشد یا متعلق به کاربر نباشد، یک خطای NOT_FOUND برگردانده می شود.

درخواست HTTP

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

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

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

پارامترها
deviceId

string

مورد نیاز. شناسه منحصر به فرد این دستگاه.

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

پارامترها
updateMask

string ( FieldMask format)

اختیاری. لیست فیلدهای AmbientDevice برای به روز رسانی.

برای مثال، برای به‌روزرسانی displayName دستگاه، مسیر فیلد userSettings.displayName باید در updateMask درخواست ارائه شود.

مقدار ویژه * ممکن است برای نشان دادن اینکه همه فیلدها (که می توانند به روز شوند) باید به روز شوند استفاده شود.

در صورت حذف، از یک ماسک فیلد ضمنی معادل تمام فیلدهایی که در device پر شده اند (یعنی مقدار غیر خالی دارند) استفاده می شود.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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