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)

התנאים וההגבלות שאושרו מהסוג הזה ועבור regionCode המשויך

required

object (Required)

התנאים וההגבלות הנדרשים

אושרו

תיאור התנאים וההגבלות שאושרו.

ייצוג ב-JSON
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
שדות
termsOfService

string

termsOfService שאושרו.

acceptedBy

string

החשבון שבו הרשאת הגישה אושרה. זה יכול להיות החשבון עצמו, או במקרה של חשבונות משנה, חשבון ה-MCA.

validUntil

object (Date)

כשהוא מוגדר, הוא מציין שTermsOfService שאושר תקף רק עד סוף התאריך הזה (לפי שעון UTC). צריך לאשר בקשה חדשה לפני כן. המידע על TermsOfService הנדרש מופיע בהודעה Required.

חובה

תיאור התנאים וההגבלות שצריך לאשר.

ייצוג ב-JSON
{
  "termsOfService": string,
  "tosFileUri": string
}
שדות
termsOfService

string

termsOfService שצריך לאשר.

tosFileUri

string

כתובת ה-URL המלאה של קובץ התנאים וההגבלות. השדה הזה זהה לשדה TermsOfService.file_uri, והוא נוסף כאן לנוחות בלבד.

Methods

get

הפונקציה מחזירה את המצב של הסכם התנאים וההגבלות.

retrieveForApplication

אחזור המצב של ההסכם לגבי התנאים וההגבלות של האפליקציה.