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

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

المورّد

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

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

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

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

التراخيص

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

العميل

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

الخطط

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

تتيح واجهة برمجة التطبيقات الخاصة بالمورّدين نظام الدفع الآجل الشهري في Google Workspace، والذي يتضمّن عدة خطط دفع متاحة:

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

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

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

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

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

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

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

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

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