Method: subscriptions.list

قوائم الاشتراكات التي يديرها المورّد ويمكن أن تتضمّن القائمة جميع اشتراكات العميل أو جميع اشتراكاته القابلة للنقل.

يمكنك اختياريًا استخدام هذه الطريقة لفلترة الردّ حسب customerNamePrefix. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الاشتراكات.

طلب HTTP

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

معامِلات طلب البحث

المعلمات
customerAuthToken

string

تكون سلسلة طلب البحث customerAuthToken مطلوبة عند إنشاء حساب توريد ينقل اشتراك عميل مباشر أو اشتراك مورّد آخر إلى إدارة المورّد. هذا رمز مصادقة سداسي عشري مطلوب لإكمال عملية نقل الاشتراك. لمزيد من المعلومات، راجع مركز مساعدة المشرفين.
customerId

string

يمكن أن يكون هذا الاسم إما اسم النطاق الأساسي للعميل أو المعرّف الفريد له. في حال تغيير اسم النطاق لعميل، لا يمكن استخدام اسم النطاق القديم للوصول إلى العميل، ولكن يمكن دائمًا استخدام المعرّف الفريد للعميل (كما تعرضه واجهة برمجة التطبيقات). ننصحك بتخزين المعرّف الفريد في أنظمتك حيثما ينطبق ذلك.
customerNamePrefix

string

عند استرداد جميع اشتراكاتك والفلترة حسب عملاء محددين، يمكنك إدخال بادئة لاسم عميل. استخدام نموذج لمجموعة عملاء تشمل exam.com وexample20.com وexample.com:

  • exa -- تعرض جميع أسماء العملاء التي تبدأ بـ "exa" والتي يمكن أن تشمل exam.com وexample20.com وexample.com. تشبه بادئة الاسم استخدام علامة النجمة، exa* في التعبير العادي.
  • example -- يعرض example20.com وexample.com.
maxResults

integer (uint32 format)

عند استرداد قائمة كبيرة، يكون maxResults هو الحد الأقصى لعدد النتائج في كل صفحة. تنقلك قيمة nextPageToken إلى الصفحة التالية. والعدد التلقائي هو 20.
pageToken

string

رمز مميّز لتحديد الصفحة التالية في القائمة

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

يدير الاشتراك علاقة خطة دفع عميل Google برمز التخزين التعريفي للمنتج وتراخيص المستخدمين وحالة الفترة التجريبية المجانية لمدة 30 يومًا وخيارات التجديد. يتمثل الدور الأساسي للمورّد في إدارة اشتراكات عميل Google.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
الحقول
kind

string

يحدّد المورد كمجموعة من الاشتراكات. القيمة: supplier#subscriptions
subscriptions[]

object (Subscription)

الاشتراكات في صفحة النتائج هذه.
nextPageToken

string

الرمز المميز للمتابعة، المستخدم في التنقل بين مجموعات النتائج الكبيرة. قدِّم هذه القيمة في طلب لاحق لعرض الصفحة التالية من النتائج.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/apps.order
  • https://www.googleapis.com/auth/apps.order.readonly

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