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

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

object (Subscription)

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

string

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، راجِع دليل التفويض.