عندما يختار مستخدم ملفًا واحدًا أو أكثر، تعرض واجهة برمجة تطبيقات Google منتقي العنصر كائنًا بتنسيق JSON. استنادًا إلى الملف الشخصي الذي تم الاختيار منه، يتم تضمين حقول مختلفة في كائن البيانات هذا.
تمثيل JSON |
---|
{ Response.ACTION: action, Response.VIEW: [ view_id, undefined, view_options { query: user_query, parent: parent_ID, ... } ], Response.DOCUMENTS: [ { Document.DESCRIPTION: description, Document.DURATION: duration, Document.EMBEDDABLE_URL: embed_URL, Document.ICON_URL: icon_URL, Document.ID: item_id, Document.IS_NEW: is_new, Document.LAST_EDITED_UTC: timestamp, Document.MIME_TYPE: MIME_type, Document.NAME: item_name, Document.PARENT_ID: parent_ID, { type: phone_type, number: phone_number, } ... ], Document.SERVICE_ID: service_id, Document.THUMBNAILS: [ { Thumbnail.URL: thumbnail_URL, Thumbnail.WIDTH: thumbnail_width, Thumbnail.HEIGHT: thumbnail_height } ... ], Document.TYPE: type, Document.URL: item_URL }, ... ], Response.PARENTS: [ { Document.DESCRIPTION: description, Document.LAST_EDITED_UTC: timestamp, Document.MIME_TYPE: MIME_type, Document.NAME: item_name, Document.ICON_URL: icon_URL, Document.ID: item_ID, Document.IS_NEW: is_new, Document.SERVICE_ID: service_id, Document.THUMBNAILS: [ { Thumbnail.URL: thumbnail_URL, Thumbnail.WIDTH: thumbnail_width, Thumbnail.HEIGHT: thumbnail_height } ... ], Document.TYPE: type, Document.URL: item_URL, }, ... ] } |
الحقول | |
---|---|
action | تمثّل هذه الخاصية Action التي يُدخلها المستخدم لإغلاق مربّع الحوار "منتقي Google". |
description | وصف للعنصر، إذا تم تقديمه. |
duration | مدة الفيديو المحدد. |
embed_URL | تمثل هذه الخاصية عنوان URL لنسخة قابلة للتضمين من العنصر. |
icon_URL | تمثّل هذه السمة عنوان URL لنسخة متاحة للجميع من الرمز، في حال توفّره. |
is_new | صحيح إذا تم تحميل العنصر المحدد ثم تم تحديده على الفور. |
item_URL | عنوان URL يرتبط مباشرة بالعنصر. |
item_id | رقم تعريف العنصر المحدّد. |
item_name | اسم العنصر المحدد. |
MIME_type | نوع MIME للعنصر المحدد (غير صالح للخرائط). |
parent_ID | معرّف العنصر الرئيسي، إن وجد. |
service_id | ServiceId تصف الخدمة التي تم اختيار هذا الملف منها. |
thumbnail_height | ارتفاع الصورة المصغّرة المتاحة للجميع. |
thumbnail_URL | تمثل هذه الخاصية عنوان URL للصورة المصغّرة المتاحة للجميع. |
thumbnail_width | تمثّل هذه الخاصية عرض الصورة المصغّرة المتاحة للجميع. |
timestamp | عدد المللي ثانية منذ 1 كانون الثاني (يناير) 1970، 00:00:00 بتوقيت غرينيتش. |
type | Type للعنصر المحدد. |
user_query | سلسلة طلب البحث، في حال ضبطها في View.setQuery() . |
view_ID | ViewId من View تم اختيار العنصر منه. |
view_options | معلومات إضافية، إن وجدت. غير محددة. |