Membuat dan menyiapkan akun penjual

Anda harus memiliki Akun Merchant Center untuk menggunakan Merchant API. Anda dapat menggunakan UI Merchant Center untuk membuatnya.

Jika perlu mengelola beberapa akun, Anda dapat membuat sub-akun menggunakan Merchant API.

Anda dapat mengonfigurasi akun di UI Merchant Center atau melalui API seperti yang dijelaskan nanti.

Setujui Persyaratan Layanan Merchant Center

Semua penjual harus menyetujui Persyaratan Layanan Merchant Center. Berikut cara menyetujui Persyaratan Layanan untuk akun penjual Anda sendiri:

  1. Hubungi accounts.termsOfServiceAgreementStates.retrieveForApplication untuk mengetahui Persyaratan Layanan yang diperlukan untuk akun Anda.

    Berikut adalah contoh permintaan:

    GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates:retrieveForApplication

    Berikut adalah contoh respons dari panggilan yang berhasil:

    {
    "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{COUNTRY}",
    "regionCode": {COUNTRY},
    "termsOfServiceKind": "MERCHANT_CENTER",
    "accepted": {
      "termsOfService": "termsOfService/{VERSION}",
      "acceptedBy": "accounts/{ACCOUNT_ID}"
    }
}

  2. Panggil termsOfService.accept untuk menyetujui Persyaratan Layanan.

    Berikut adalah contoh permintaan:

    GET https://merchantapi.googleapis.com/accounts/v1beta/{name=termsOfService/{VERSION}}:accept

    Jika berhasil, isi respons akan kosong.

Sebaiknya buat UI tempat Anda menampilkan TOS kepada penjual, dan minta mereka untuk menyetujuinya.

  1. Temukan TOS yang harus disetujui penjual menggunakan termsOfService.retrieveLatest dengan regionCode bisnis.

    Berikut adalah contoh permintaan:

    GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest

    Berikut adalah contoh respons dari panggilan yang berhasil:

    {
    "name": "termsOfService/{VERSION}",
    "regionCode": "{COUNTRY}",
    "kind": "MERCHANT_CENTER",
    "fileUri": "{URI}"
}

  2. Menampilkan TOS dari fileUri kepada penjual.

  3. Saat penjual menyetujui TOS di UI Anda, panggil termsOfService.accept dengan name TOS yang akan disetujui.

Berikut adalah contoh yang dapat Anda gunakan untuk menyetujui perjanjian Persyaratan Layanan untuk akun tertentu:

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1beta import AcceptTermsOfServiceRequest
from google.shopping.merchant_accounts_v1beta import TermsOfServiceServiceClient

# Replace with your actual values.
_ACCOUNT_ID = configuration.Configuration().read_merchant_info()
_TOS_VERSION = (  # Replace with the Terms of Service version to accept
    "VERSION_HERE"
)
_REGION_CODE = "US"  # Replace with the region code


def accept_terms_of_service():
  """Accepts the Terms of Service agreement for a given account."""

  credentials = generate_user_credentials.main()
  client = TermsOfServiceServiceClient(credentials=credentials)

  # Construct the request
  request = AcceptTermsOfServiceRequest(
      name=f"termsOfService/{_TOS_VERSION}",
      account=f"accounts/{_ACCOUNT_ID}",
      region_code=_REGION_CODE,
  )

  try:
    print("Sending request to accept terms of service...")
    client.accept_terms_of_service(request=request)
    print("Successfully accepted terms of service.")
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  accept_terms_of_service()

accept_terms_of_service_sample.py

Setelah penjual menyetujui TOS, Anda dapat menggunakan Merchant API untuk menyiapkan informasi akun lainnya. Untuk mengetahui detail tentang informasi akun yang dapat Anda kelola dengan Merchant Accounts API, lihat resource Account.

Mengklaim situs Anda

Anda dapat menggunakan Merchant Accounts API untuk menambahkan dan mengklaim Homepage bisnis Anda.

  1. Untuk menambahkan halaman beranda ke akun Anda, panggil accounts.updateHomepage dengan resource Homepage yang berisi URL halaman beranda Anda.
  2. Untuk mengklaim kepemilikan halaman beranda, panggil accounts.homepage.claim dengan name dari resource Hompeage Anda.

Anda tidak dapat menggunakan Merchant API untuk memverifikasi halaman beranda. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi dan mengklaim situs toko.

Memperbarui detail bisnis

Anda dapat menggunakan Merchant Accounts API untuk mengedit PostalAddress, CusomerService, dan BusinessIdentity bisnis Anda.

Identitas bisnis:

Langkah berikutnya

Sebelumnya
Overview
Berikutnya
Create and manage sub-accounts