- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ConsolidationStrategy
- NoConsolidation
- الإصدار القديم
- جرِّبه الآن
طلب بحث عن النشاط السابق في Google Drive
طلب HTTP
POST https://driveactivity.googleapis.com/v2/activity:query
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "consolidationStrategy": { object ( |
الحقول | |
---|---|
consolidationStrategy |
تفاصيل عن كيفية دمج الإجراءات ذات الصلة التي يتألف منها النشاط. وفي حال ترك هذه السياسة بدون ضبط، لن يتم دمج الإجراءات ذات الصلة. |
pageSize |
الحد الأدنى لعدد الأنشطة المطلوبة في الاستجابة؛ يحاول الخادم عرض هذه الكمية على الأقل. وقد يعرض الخادم أيضًا أنشطة أقل إذا كانت لديه استجابة جزئية جاهزة قبل انتهاء مهلة الطلب. وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام قيمة تلقائية. |
pageToken |
ويحدد الرمز المميز صفحة النتائج المراد عرضها. عيِّن هذا على قيمة nextPageToken التي يتم عرضها من استعلام سابق للحصول على صفحة النتائج التالية. وفي حال ترك هذه السياسة بدون ضبط، يتم عرض الصفحة الأولى من النتائج. |
filter |
فلترة العناصر التي تم إرجاعها من طلب البحث هذا. تنسيق سلسلة الفلتر هو سلسلة من التعبيرات، مرتبطة بعلامة "AND" اختيارية، حيث يكون كل تعبير على شكل "قيمة عامل التشغيل الحقل". الحقول المتاحة:
|
حقل الاتحاد key المعايير الأساسية في طلب البحث. القيمة التلقائية هي ancestorName = items/root ، إذا لم يتم تحديد أي مفتاح. يمكن أن تكون السمة "key " واحدة فقط مما يلي: |
|
itemName |
عرض الأنشطة لعنصر Drive هذا. التنسيق هو |
ancestorName |
عرض الأنشطة لمجلد Drive هذا، بالإضافة إلى جميع العناصر الثانوية والعناصر التابعة التنسيق هو |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة الردّ على طلب البحث عن نشاط Drive
تمثيل JSON |
---|
{
"activities": [
{
object ( |
الحقول | |
---|---|
activities[] |
قائمة الأنشطة المطلوبة |
nextPageToken |
رمز مميز لاسترداد الصفحة التالية من النتائج، أو يكون فارغًا إذا لم تكن هناك نتائج أخرى في القائمة. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive.activity
https://www.googleapis.com/auth/drive.activity.readonly
لمزيد من المعلومات، راجِع دليل التفويض.
ConsolidationStrategy
كيفية دمج الأنشطة الفردية في حال ارتباط مجموعة من الأنشطة، يمكن دمجها في نشاط واحد مجمّع، مثل تنفيذ الإجراء نفسه على عدة أهداف، أو العديد من الجهات الفاعلة التي تنفّذ الإجراء نفسه على هدف واحد. تحدد الإستراتيجية القواعد التي ترتبط بها الأنشطة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد strategy كيفية دمج الأنشطة الفردية يمكن أن تكون السمة "strategy " واحدة فقط مما يلي: |
|
none |
ولا يتم دمج الأنشطة الفردية. |
legacy |
ويتم دمج الأنشطة الفردية باستخدام الاستراتيجية القديمة. |
NoConsolidation
استراتيجية لا توحّد الأنشطة الفردية.
قديمة
استراتيجية توحِّد الأنشطة باستخدام قواعد التجميع من V1 Activity API القديمة. ويمكن تجميع الإجراءات المشابهة التي تحدث خلال فترة زمنية معيَّنة على مستوى أهداف متعددة (مثل نقل مجموعة من الملفات في آنٍ واحد) أو العديد من الجهات الفاعلة (مثل تعديل عدة مستخدمين للعنصر نفسه). تكون قواعد التجميع لهذه الإستراتيجية خاصة بكل نوع من الإجراءات.