Products: list

للعثور على المنتجات الموافق عليها التي تتطابق مع طلب بحث، أو جميع المنتجات التي تمت الموافقة عليها في حال عدم وجود طلب بحث.

الطلب

طلب HTTP

GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/products

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
enterpriseId string رقم تعريف المؤسسة.
مَعلمات طلب البحث الاختيارية
approved boolean تحدّد ما إذا كنت تريد البحث بين جميع المنتجات (خطأ) أو بين المنتجات التي تمت الموافقة عليها فقط (صحيح). لا يُسمح سوى بالقيمة "true"، ويجب تحديدها.
language string علامة BCP47 للغة المفضّلة لدى المستخدم (مثل "en-US" أو "de"). يتم عرض النتائج باللغة المفضّلة التي تتطابق مع اللغة المفضّلة
maxResults unsigned integer تحدّد هذه السمة الحد الأقصى لعدد المنتجات التي يمكن إرجاعها في كل طلب. في حال عدم تحديده، يتم استخدام القيمة التلقائية 100، وهي أيضًا الحد الأقصى القابل للاسترجاع داخل استجابة واحدة.
query string طلب البحث كما هو مكتوب في مربّع البحث في "متجر Google Play" وفي حال حذفها، سيتم عرض جميع التطبيقات التي تمت الموافقة عليها (باستخدام مَعلمات التقسيم على صفحات)، بما في ذلك التطبيقات غير المتاحة في المتجر (مثل التطبيقات التي تم إلغاء نشرها).
token string يحتوي استجابة الطلب على رمز للتقسيم على صفحات في حال توفُّر المزيد من المنتجات. ويمكن استخدام الرمز المميّز في طلب لاحق للحصول على مزيد من المنتجات، وهكذا. لا يمكن استخدام هذه المَعلمة في الطلب الأولي.

التفويض

يتطلب هذا الطلب تفويضًا بالنطاق التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.

الإجابة

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

{
  "kind": "androidenterprise#productsListResponse",
  "pageInfo": {
    "totalResults": integer,
    "resultPerPage": integer,
    "startIndex": integer
  },
  "tokenPagination": {
    "nextPageToken": string,
    "previousPageToken": string
  },
  "product": [
    products Resource
  ]
}
اسم الموقع القيمة الوصف Notes
tokenPagination nested object معلومات حول تقسيم النتائج على عدّة صفحات للرمز المميّز على صفحات
tokenPagination.nextPageToken string
product[] list معلومات حول منتج (مثل تطبيق) في "متجر Google Play" لعرضها لأحد مشرفي المؤسسة
pageInfo nested object معلومات عامة عن تقسيم النتائج على عدّة صفحات.
pageInfo.totalResults integer
pageInfo.resultPerPage integer
pageInfo.startIndex integer
tokenPagination.previousPageToken string
kind string يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "androidenterprise#productsListResponse".