REST Resource: accounts.termsOfServiceAgreementStates

Resource: termsOfServiceAgreementState

Resource ini mewakili status perjanjian untuk akun dan jenis persyaratan layanan tertentu. Statusnya adalah sebagai berikut:

  • Jika penjual telah menyetujui persyaratan layanan: diterima akan diisi, jika tidak, persyaratan ini akan kosong
  • Jika penjual harus menandatangani persyaratan layanan: wajib akan diisi, jika tidak, persyaratan ini akan kosong.

Perhatikan bahwa nilai wajib dan diterima dapat ada. Dalam hal ini, persyaratan layanan accepted akan memiliki tanggal habis masa berlaku yang ditetapkan di kolom validUntil. Persyaratan layanan required harus disetujui sebelum validUntil agar akun dapat terus memiliki perjanjian yang valid. Saat menyetujui persyaratan layanan baru, kami mengharapkan pihak ketiga menampilkan teks yang terkait dengan perjanjian persyaratan layanan tertentu (URL ke file yang berisi teks ditambahkan dalam pesan Wajib di bawah sebagai tosFileUri. Penerimaan persyaratan layanan sebenarnya dilakukan dengan memanggil setuju pada resource TermsOfService.

Representasi JSON
{
  "name": string,
  "regionCode": string,
  "termsOfServiceKind": enum (TermsOfServiceKind),
  "accepted": {
    object (Accepted)
  },
  "required": {
    object (Required)
  }
}
Kolom
name

string

ID. Nama resource versi persyaratan layanan. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Format ID adalah: {TermsOfServiceKind}-{country} Misalnya, ID dapat berupa: MERCHANT_CENTER-US

regionCode

string

Kode wilayah seperti yang ditentukan oleh https://cldr.unicode.org/. Ini adalah negara tempat status saat ini berlaku.

termsOfServiceKind

enum (TermsOfServiceKind)

Jenis Persyaratan Layanan yang terkait dengan versi tertentu.

accepted

object (Accepted)

Persyaratan layanan yang diterima semacam ini dan untuk regionCode terkait

required

object (Required)

Persyaratan layanan yang diperlukan

Diterima

Menjelaskan persyaratan layanan yang diterima.

Representasi JSON
{
  "termsOfService": string,
  "acceptedBy": string,
  "validUntil": {
    object (Date)
  }
}
Kolom
termsOfService

string

termsOfService yang diterima.

acceptedBy

string

Akun tempat penerimaan dicatat. Ini dapat berupa akun itu sendiri atau, untuk sub-akun, akun MCA.

validUntil

object (Date)

Jika ditetapkan, pernyataan tersebut menyatakan bahwa TermsOfService yang diterima hanya berlaku hingga akhir tanggal ini (dalam UTC). Dokumen baru harus disetujui sebelum tanggal tersebut. Informasi TermsOfService wajib ada dalam pesan Wajib.

Wajib

Menjelaskan persyaratan layanan yang harus disetujui.

Representasi JSON
{
  "termsOfService": string,
  "tosFileUri": string
}
Kolom
termsOfService

string

termsOfService yang harus diterima.

tosFileUri

string

URL lengkap ke file persyaratan layanan. Kolom ini sama dengan TermsOfService.file_uri, dan ditambahkan di sini hanya untuk memudahkan.

Metode

get

Menampilkan status perjanjian persyaratan layanan.

retrieveForApplication

Mengambil status perjanjian untuk persyaratan layanan aplikasi.