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