مواد العرض: البحث

البحث عن مواد عرض مستخدم في "مركز البيانات"

طلب

طلب HTTP

GET https://datastudio.googleapis.com/v1/assets:search

المَعلمات

اسم المعلَمة النوع الوصف
assetTypes Array<AssetType> مَعلمة مطلوبة. نوع مادة العرض المطلوب البحث عنها. يجب تحديد نوع مادة عرض واحد فقط.
title سلسلة سلسلة البحث يتم تلقائيًا التحقّق من السلسلة مقارنةً بعنوان مادة العرض ووصفها. يمكنك الاطّلاع على قسم الأمثلة للاطّلاع على سلاسل البحث المتقدّم.
includeTrashed قيمة منطقية القيمة التلقائية هي false.
  • عند ضبط هذه المَعلمة على true، يتم تضمين مواد العرض من المهملات فقط.
  • عند ضبط هذه المَعلمة على false، يتم تضمين مواد العرض غير الموجودة في المهملات فقط.
المالك سلسلة عنوان البريد الإلكتروني لمالك مادة العرض
orderBy سلسلة ترتيب النتائج يمكنك الترتيب حسب الحقول التالية:
  • title
  • last_viewed_by_me
  • create_time
  • last_accessed_time
  • id
pageSize الرقم عدد النتائج المطلوب تضمينها في كل صفحة القيمة التلقائية هي 1000.
pageToken سلسلة تمثّل هذه السمة رمزًا مميزًا يحدّد صفحة من النتائج المطلوب عرضها. لتقسيم النتائج إلى صفحات، استخدِم القيمة nextPageToken أو القيمة previousPageToken من طلب آخر.

التفويض

يتطلّب هذا الطلب الحصول على تفويض باستخدام نطاق واحد على الأقل من النطاقات التالية:

النطاق
https://www.googleapis.com/auth/datastudio.readonly
https://www.googleapis.com/auth/datastudio

نص الطلب

لا تقدّم نص طلب مع هذه الطريقة.

الردّ

في حال نجاح العملية، يعرض هذا الإجراء نص استجابة بالبنية التالية:

{
  "assets": [Asset],
  "nextPageToken": string
}
اسم السمة النوع الوصف
الأصول Array<Asset> قائمة مواد العرض
nextPageToken سلسلة رمز مميز لاسترداد الصفحة التالية من النتائج. لا تظهر هذه السمة إلا عندما يكون عدد النتائج أكبر من قيمة الطلب pageSize. يشير nextPageToken فارغ إلى عدم توفّر المزيد من النتائج لعرضها.
previousPageToken سلسلة رمز مميز لاسترداد الصفحة السابقة من النتائج. يشير previousPageToken الفارغ إلى بداية مجموعة النتائج.

أمثلة

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

تصفية التعريف أمثلة
صانع المحتوى البحث عن مواد عرض أنشأها مستخدم معيّن
  • creator:me
  • creator:user@example.com
المالك البحث عن مواد عرض يملكها مستخدم معيّن
  • owner:me
  • owner:user@example.com
المشروع البحث عن مواد عرض في مشروع
  • projectNumber:123456789
Workspace ابحث عن مواد عرض في مساحة عمل أو مجلد.
  • parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
من ابحث عن الأصول التي شاركها معك أحد المستخدمين.
  • from:user@example.com
إلى البحث عن مواد عرض شاركتها مع مستخدم أو مجموعة
  • to:user@example.com
  • to:example-group@googlegroups.com