يمكن أن يكون هذا الاسم إما اسم النطاق الأساسي للعميل أو المعرّف الفريد له. في حال تغيير اسم النطاق لعميل، لا يمكن استخدام اسم النطاق القديم للوصول إلى العميل، ولكن يمكن دائمًا استخدام المعرّف الفريد للعميل (كما تعرضه واجهة برمجة التطبيقات). ننصحك بتخزين المعرّف الفريد في أنظمتك حيثما ينطبق ذلك.
subscriptionId
string
هذه سمة مطلوبة. subscriptionId هو معرّف الاشتراك وهو فريد لكل عميل. وبما أنّ subscriptionId يتغيّر عند تعديل الاشتراك، ننصحك بعدم استخدام هذا المعرّف كمفتاح للبيانات المستمرة. ويمكن العثور على subscriptionId باستخدام طريقة استرداد جميع اشتراكات المورِّدين.
هذه سمة مطلوبة. وسمة المقاعد هي عدد تراخيص تراخيص المستخدمين.
purchaseOrderId
string
هذه سمة اختيارية. إنّ معلومات طلب الشراء هذه مخصَّصة للمورّدين بهدف استخدامها لأغراض التتبُّع في شركتهم. في حال توفير قيمة purchaseOrderId، ستظهر في الردود من واجهة برمجة التطبيقات وستظهر في الفاتورة. تقبل السمة ما يصل إلى 80 حرفًا من أحرف النص العادي.
dealCode
string
رمز صادر عن Google (100 حرف كحدّ أقصى) للأسعار المخفّضة على خطط الاشتراك يجب تضمين رمز الصفقة في طلب changePlan للحصول على السعر المخفّض. هذه السمة اختيارية. إذا سبق إضافة رمز صفقة إلى اشتراك، قد يتم ترك هذا الموقع فارغًا وسيظل السعر المخفَّض الحالي ساريًا (إذا لم يكن فارغًا، يُرجى تقديم رمز الصفقة المتوفّر فقط في الاشتراك فقط). في حال عدم إضافة رمز صفقة إلى اشتراك من قبل وترك هذا الموقع فارغًا، سيتم تطبيق الأسعار العادية.
تاريخ التعديل الأخير: 2024-09-09 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Updates a subscription's plan, allowing changes from trial or flexible plans to annual commitments with monthly or yearly payments, with varying update processes based on the specific plan and products."],["Requires sending a POST request to a specific URL, including the `customerId` and `subscriptionId` as path parameters."],["The request body must contain a `ChangePlanRequest` object specifying the desired plan name, number of seats, and optional purchase order ID and deal code."],["Successful responses return a `Subscription` object representing the updated subscription."],["Requires authorization with the `https://www.googleapis.com/auth/apps.order` scope."]]],[]]
