Method: devices.patch

تعديل المعلومات حول الجهاز المحدّد

يتم عرض الخطأ NOT_FOUND إذا لم يكن الجهاز متوفّرًا أو لم يكن مملوكًا للمستخدم.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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