Method: devices.create

إنشاء جهاز الإضاءة السينمائية في حساب المستخدم على "صور Google"

إذا كان هناك جهاز يتضمّن requestId المقدَّم، يتم عرض خطأ ALREADY_EXISTS. للمساعدة في منع ظهور أجهزة مكرّرة، عليك اتّباع الخطوات التالية:

  • إذا كنت تعرف deviceId للجهاز الحالي، يُرجى الاتصال برقم devices.get لاسترداده.
  • إذا لم تكن تعرف deviceId، يُرجى الاتصال بـ devices.delete باستخدام requestId لإزالة الجهاز غير المرتبط بحساب قبل إعادة محاولة هذه الطريقة.

يمكنك إنشاء ما يصل إلى 100 جهاز لكل مستخدم من مستخدمي تطبيقك. وفي حال تجاوز هذا الحدّ، يتم عرض خطأ RESOURCE_EXHAUSTED.

طلب HTTP

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

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

مَعلمات طلب البحث

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