REST Resource: accounts.termsOfServiceAgreementStates

المورد: termsOfServiceAgreementState

يمثّل هذا المورد حالة الاتفاقية لنوع معيّن من الحساب وبنود الخدمة. الولاية هي كما يلي:

  • إذا وافق التاجر على بنود الخدمة: ستتم تعبئة الحقل مقبول، وبخلاف ذلك، ستكون القيمة فارغة.
  • إذا كان على التاجر توقيع بنود الخدمة: ستتم تعبئة الحقل مطلوب، وبخلاف ذلك، سيكون الحقل فارغًا.

يُرجى العِلم أنّ كلاً من القيم المطلوبة والمقبولة يمكن أن تكون مضمَّنة. في هذه الحالة، سيكون لبنود خدمة accepted تاريخ انتهاء صلاحية تم ضبطه في الحقل validUntil. يجب قبول بنود خدمة "required" قبل validUntil حتى يستمرّ الحساب في الحصول على اتفاقية صالحة. عند قبول بنود الخدمة الجديدة، نتوقّع من الجهات الخارجية عرض النص المرتبط باتفاقية بنود الخدمة المحدّدة (تتم إضافة عنوان URL للملف الذي يحتوي على النصّ في الرسالة المطلوبة أدناه على النحو التالي: tosFileUri. تتم الموافقة الفعلية لبنود الخدمة من خلال استدعاء خيار "قبول" في مورد TermsOfService.

تمثيل JSON 
{
  "name": string,
  "regionCode": string,
  "termsOfServiceKind": enum (TermsOfServiceKind),
  "accepted": {
    object (Accepted)
  },
  "required": {
    object (Required)
  }
}
الحقول
name

string

المُعرّف. اسم المورد لإصدار بنود الخدمة تنسيق الملف: accounts/{account}/termsOfServiceAgreementState/{identifier}
regionCode

string

رمز المنطقة على النحو المحدّد في https://cldr.unicode.org/. هذا هو البلد الذي تنطبق عليه الولاية الحالية.
termsOfServiceKind

enum (TermsOfServiceKind)

نوع بنود الخدمة المرتبط بالإصدار المحدّد
accepted

object (Accepted)

بنود الخدمة المقبولة من هذا النوع ولرمز المنطقة المرتبط بها
required

object (Required)

بنود الخدمة المطلوبة

عدد الرسائل المقبولة

تصف بنود الخدمة المقبولة.

تمثيل JSON 
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
الحقول
termsOfService

string

termsOfService المقبولة
acceptedBy

string

الحساب الذي تم تسجيل الموافقة فيه. يمكن أن يكون هذا الحساب هو نفسه أو حساب متعدّد العملاء في حال الحسابات الفرعية.
validUntil

object (Date)

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

مطلوبة

تصف الخدمة بنود الخدمة المطلوب قبولها

تمثيل JSON 
{
  "termsOfService": string,
  "tosFileUri": string
}
الحقول
termsOfService

string

termsOfService التي يجب قبولها.
tosFileUri

string

عنوان URL الكامل لملف بنود الخدمة. يشبه هذا الحقل الحقل TermsOfService.file_uri، إذ تتم إضافته هنا لتيسير الأمر فقط.

الطُرق

get

 تعرض حالة اتفاقية بنود الخدمة.

retrieveForApplication

 استرداد حالة الاتفاقية الخاصة ببنود الخدمة الخاصة بالطلب.