يمكن إدخال إما اسم النطاق الأساسي للعميل أو المعرّف الفريد للعميل. في حال تغيير اسم النطاق لأحد العملاء، لا يمكن استخدام اسم النطاق القديم للوصول إلى العميل، ولكن يمكن دائمًا استخدام المعرّف الفريد للعميل (كما تعرضه واجهة برمجة التطبيقات). وننصحك بتخزين المعرّف الفريد في أنظمتك حيثما أمكن.
subscriptionId
string
هذه سمة مطلوبة. subscriptionId هو معرّف الاشتراك وهو فريد لكل عميل. بما أنّ subscriptionId تتغير عند تعديل الاشتراك، ننصحك بعدم استخدام رقم التعريف هذا كمفتاح للبيانات الدائمة. ويمكن العثور على subscriptionId باستخدام طريقة استرداد جميع اشتراكات المورّدين.
هذه سمة مطلوبة. قيمة ترخيص المستخدمين هي عدد تراخيص تراخيص المستخدمين.
purchaseOrderId
string
هذه السمة اختيارية. إنّ معلومات طلب الشراء هذه مخصّصة للمورّدين لاستخدامها في تتبُّع شركتهم. وفي حال إضافة قيمة purchaseOrderId، ستظهر في ردود واجهة برمجة التطبيقات وستظهر في الفاتورة. تقبل السمة ما يصل إلى 80 حرفًا من أحرف النص العادي.
dealCode
string
رمز صادر عن Google (100 حرف كحدٍ أقصى) للحصول على سعر مخفَّض على خطط الاشتراك. يجب تضمين رمز الصفقة في طلب "changePlan" للحصول على سعر مخفَّض. هذه السمة اختيارية. في حال سبق أن أضفت رمز صفقة إلى اشتراك، قد يتم ترك هذا الموقع فارغًا وسيظل السعر المخفّض الحالي ساريًا (إذا لم يكن فارغًا، قدِّم رمز الصفقة المتوفّر في الاشتراك فقط). في حال لم تتم إضافة رمز صفقة إلى اشتراك من قبل وترك هذا الموقع فارغًا، سيتم تطبيق الأسعار العادية.