قوائم الاشتراكات التي يديرها المورِّد. يمكن أن تتضمّن القائمة جميع الاشتراكات أو جميع اشتراكات العميل أو جميع اشتراكات العميل القابلة للنقل.
يمكن لهذه الطريقة فلترة الردّ حسب customerNamePrefix
(إجراء اختياري). لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الاشتراكات.
طلب HTTP
GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
customerAuthToken |
يجب إدخال سلسلة طلب البحث |
customerId |
يمكن إدخال إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل. في حال تغيير اسم النطاق لأحد العملاء، لا يمكن استخدام اسم النطاق القديم للوصول إلى العميل، ولكن يمكن دائمًا استخدام المعرّف الفريد للعميل (كما تعرضه واجهة برمجة التطبيقات). وننصحك بتخزين المعرّف الفريد في أنظمتك حيثما أمكن. |
customerNamePrefix |
عند استرداد جميع اشتراكاتك والفلترة لعملاء محدّدين، يمكنك إدخال بادئة لاسم العميل. باستخدام نموذج لمجموعة عملاء تتضمّن
|
maxResults |
عند استرداد قائمة كبيرة، يكون |
pageToken |
الرمز المميز لتحديد الصفحة التالية في القائمة |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
يدير الاشتراك علاقة خطة الدفع لعميل Google برمز التخزين التعريفي للمنتج وتراخيص المستخدم وحالة الفترة التجريبية المجانية لمدة 30 يومًا وخيارات التجديد. يتمثل الدور الأساسي للمورّد في إدارة اشتراكات عميل Google.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"subscriptions": [
{
object ( |
الحقول | |
---|---|
kind |
تحدد المورد على أنّه مجموعة من الاشتراكات. القيمة: resource#subscriptions |
subscriptions[] |
الاشتراكات في هذه الصفحة من النتائج |
nextPageToken |
هو الرمز المميّز للمتابعة والذي يُستخدم في الصفحات من خلال مجموعات النتائج الكبيرة. أدخِل هذه القيمة في طلب لاحق لعرض الصفحة التالية من النتائج. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/apps.order
https://www.googleapis.com/auth/apps.order.readonly
لمزيد من المعلومات، راجِع دليل التفويض.