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

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

object (Subscription)

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

string

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

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

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

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

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