للعثور على المنتجات الموافق عليها التي تتطابق مع طلب بحث، أو جميع المنتجات التي تمت الموافقة عليها في حال عدم وجود طلب بحث.
الطلب
طلب 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" . |