REST Resource: sessions

المرجع: PickingSession

تمثيل لجلسة مستخدم يمكنه خلالها اختيار الصور والفيديوهات باستخدام "صور Google"

تمثيل JSON
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "mediaItemsSet": boolean
}
الحقول
id

string

النتائج فقط. المعرِّف الذي أنشأته Google لهذه الجلسة.

pickerUri

string

النتائج فقط. معرّف الموارد المنتظم (URI) المستخدَم لإعادة توجيه المستخدم إلى "صور Google" (على الويب) كي يتمكّن من اختيار الصور والفيديوهات للجلسة الحالية

لعرض هذه الصفحة بنجاح، يجب أن يكون المستخدم مسجّلاً الدخول إلى حساب Google الذي يملك هذه الجلسة في متصفّح الويب.

لا يمكن فتح pickerUri في إطار iframe لأسباب تتعلق بالأمان.

pollingConfig

object (PollingConfig)

النتائج فقط. الإعدادات المقترَحة التي يجب أن تستخدمها التطبيقات أثناء الاستعلام عن sessions.get

لا تتم تعبئة هذا الحقل إلا إذا لم يتم اختيار عناصر وسائط لهذه الجلسة بعد (أي mediaItemsSet غير صحيح).

expireTime

string (Timestamp format)

النتائج فقط. الوقت الذي ستنتهي فيه صلاحية الوصول إلى هذه الجلسة (وعناصر الوسائط التي تم اختيارها)

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

mediaItemsSet

boolean

النتائج فقط. في حال ضبط القيمة على true، يعني ذلك أنّه تم اختيار عناصر وسائط لهذه الجلسة ويمكن لتطبيقك طلب قائمة عناصر الوسائط التي تم اختيارها من خلال mediaItems.list.

PollingConfig

إعدادات طلب البيانات من واجهة برمجة التطبيقات

تمثيل JSON
{
  "pollInterval": string,
  "timeoutIn": string
}
الحقول
pollInterval

string (Duration format)

النتائج فقط. الوقت المُقترَح بين طلبات الاستطلاع

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"

timeoutIn

string (Duration format)

النتائج فقط. المدة الزمنية التي يجب أن يتوقف فيها العميل عن الاستطلاع.

تشير القيمة 0 إلى أنّ العميل يجب أن يتوقف عن الاستطلاع إذا لم يحدث ذلك بعد.

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"

الطُرق

create

إنشاء جلسة جديدة يمكن للمستخدم خلالها اختيار الصور والفيديوهات للوصول إليها من خلال جهة خارجية

delete

لحذف الجلسة المحدّدة.

get

يستردّ معلومات عن الجلسة المحدّدة.