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

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

المورّد

يشتري المورّد تراخيص المستخدمين من Google ويعيد بيع هذه التراخيص لعملاء 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"

لمزيد من المعلومات حول هذه الخطط، يُرجى الاطّلاع على مقالة اختيار خطة دفع لعملائك.

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

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

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

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

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

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

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