REST Resource: accounts.termsOfServiceAgreementStates

المورد: TermsOfServiceAgreementState

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

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

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

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

string

المعرّف اسم المرجع لنسخة بنود الخدمة. التنسيق: accounts/{account}/termsOfServiceAgreementState/{identifier} تنسيق المعرّف هو: {TermsOfServiceKind}-{country} على سبيل المثال، يمكن أن يكون المعرّف: MERCHANT_CENTER-US
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

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

object (Date)

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

مطلوب

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

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

string

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

string

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

الطُرق

get

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

retrieveForApplication

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