نظرة عامة على واجهة برمجة تطبيقات المورّد

توفّر Google منتجات للمستخدمين من خلال قنوات توزيع، مثل مورّدي Google Workspace المعتمَدين. عند استخدام Reseller API، يجب فهم العلاقات المفاهيمية بين المورّدين والعملاء وخطط الدفع ووحدات حفظ المخزون (SKU) الخاصة بالمنتجات والتراخيص.

المورّد

يشتري المورّد تراخيص المستخدمين من Google ويعيد بيعها للعملاء. يمكن للمورِّد إدارة اشتراكات العملاء مباشرةً أو العمل مع موفّر خدمات متكاملة لإدارة العملاء عند تخصيص خدمات متعدّدة.

يمكن للمورّدين الاختيار من بين الخطط التالية:

  • الاشتراك السنوي: يشتري المورّد عددًا ثابتًا من التراخيص من Google لمدة عام واحد. يمكن للعملاء إنشاء ما يصل إلى عدد التراخيص، ولكن تتم فوترة المورّدين مقابل عدد التراخيص المطلوبة. لزيادة عدد التراخيص، يمكن للمورّدين استخدام طريقة subscriptions.changeSeats.
  • مرنة: في كل مرة ينشئ فيها العميل مستخدمًا جديدًا، تحصّل Google من المورّد ترخيصًا. يصف عقد المورّد مع Google السعر والمواصفات والحد الأقصى لعدد التراخيص.

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

التراخيص

يتيح الترخيص للمستخدم الذي لديه حساب على Google الوصول إلى خدمات Google Workspace. عندما يمنح العميل ترخيصًا لمستخدم، يصبح الترخيص نشطًا. لا يتم احتساب سوى التراخيص النشطة ضمن إجمالي عدد المستخدمين لدى العميل.

العميل

يبدأ عميل Google باستخدام حساب Google Workspace يضبطه المورّد. عند إعداد الحساب، يقدّم المورّد اسم نطاق أساسيًا وعنوان بريد إلكتروني بديلًا وعنوانًا جغرافيًا. ينشئ المورِّد أيضًا اشتراكًا لكل رمز تخزين تعريفي (SKU) خاص بالمنتج ومتاح للعميل. يستضيف العميل حساب كل مستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على طلب حساب عميل جديد.

الخطط

تحدّد الخطة بنود الفوترة الخاصة بالمورّد مع Google. لا تحدّد هذه الخطط علاقة الفوترة بين المورّد وعملائه. يحدّد المورِّدون بنود الفوترة الخاصة بهم مع عملائهم.

تتيح Reseller API نظام الدفع عند الاستخدام الشهري في Google Workspace، والذي يتضمّن خطط الدفع التالية:

  • ANNUAL_MONTHLY_PAY: اشتراك سنوي مع دفعات شهرية
  • ANNUAL_YEARLY_PAY: التزام سنوي بدفعة واحدة سنويًا
  • FLEXIBLE: خطة بدون التزام بدفعات شهرية
  • TRIAL: خطة الفترة التجريبية المجانية
    • تتراوح مدة الفترة التجريبية حتى 30 يومًا.
    • الحدّ الأقصى لعدد الرسائل المسموح بإرسالها يوميًا في Gmail هو 500 رسالة لكل مستخدم.
  • FREE: الخطة المجانية للاشتراكات في النسخة المجانية من Cloud Identity فقط.

لمزيد من المعلومات، اطّلِع على مقالة اختيار خطة دفع لعملائك.

تاريخ التوفّر للمشتركين

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

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

لكل اشتراك معرّف فريد، وهو subscriptionId. بما أنّ قيمة subscriptionId تتغيّر عند تغيير الاشتراك، لا تستخدِمها كمفتاح للبيانات الثابتة.

لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الاشتراكات.

المنتجات ورموز التخزين التعريفية للمنتجات

المنتج هو عرض تجاري لخدمات Google وتطبيقاتها. يمكن أن يتضمّن المنتج إصدارات مخصّصة من البنود والأسعار وتفاصيل الاتفاقية الأخرى. يتم تحديد كل إصدار من خلال حزمة SKU للمنتج. توفّر واجهة Reseller API اشتراكات في رموز التخزين التعريفية ضمن منتجات Google Workspace وGoogle Vault وGoogle Drive. لمزيد من المعلومات، يُرجى الاطّلاع على المنتجات ورموز التخزين التعريفية.