Halaman ini diterjemahkan oleh Cloud Translation API.

Status akun

Anda dapat menggunakan resource accountstatuses untuk melihat status akun Merchant Center, atau MCA (akun multiklien) dan semua sub-akun yang terkait dengannya.

Penjual yang memiliki beberapa toko online atau merek yang dijual di situs terpisah dapat memilih untuk memiliki sub-akun berdasarkan MCA.

Penjual bertanggung jawab untuk mematuhi kebijakan iklan Shopping dan listingan gratis. Google Shopping berhak menegakkan kebijakan ini dan melakukan tindakan yang sesuai jika kami menemukan konten atau perilaku yang melanggar kebijakan ini.

Baca referensi Masalah akun untuk mengetahui detail masalah umum akun.

accountstatuses.get

Anda dapat menggunakan accountstatuses.get untuk melihat informasi status akun untuk satu akun penjual.

Anda dapat menggunakan parameter destination untuk mengontrol masalah produk yang akan ditampilkan. Jika tujuan tidak ditentukan, respons default akan menyertakan status untuk destination: Shopping.

Berikut adalah contoh permintaan, dengan merchantId adalah ID akun MCA dan accountId adalah sub-akun MCA tersebut:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId

Untuk mendapatkan informasi status akun bagi akun mandiri, panggil accountstatuses.get dengan ID akun yang sama untuk merchantId dan accountId.

Metode ini akan menampilkan masalah tingkat akun dan item. Anda dapat menggunakan referensi Iklan Shopping dan Listingan gratis untuk memperbaiki accountLevelIssues yang ditampilkan dalam respons dari accountstatuses.get.

Berikut contoh respons untuk sub-akun yang ditangguhkan karena pelanggaran "halaman landing tidak berfungsi".

{
 "kind": "content#accountStatus",
 "accountId": "123456789",
 "websiteClaimed": true,
 "accountLevelIssues": [
  {
   "id": "editorial_and_professional_standards_destination_url_down_policy",
   "title": "Account suspended due to policy violation: landing page not working",
   "country": "US",
   "severity": "critical",
   "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
  },
  {
   "id": "missing_ad_words_link",
   "title": "No Google Ads account linked",
   "severity": "error",
   "documentation": "https://support.google.com/merchants/answer/6159060"
  }
 ],
 "products": [
  {
   "channel": "online",
   "destination": "Shopping",
   "country": "US",
   "statistics": {
    "active": "0",
    "pending": "0",
    "disapproved": "5",
    "expiring": "0"
   },
   "itemLevelIssues": [
    {
     "code": "image_link_broken",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "image link",
     "description": "Invalid image [image link]",
     "detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
     "documentation": "https://support.google.com/merchants/answer/6098289",
     "numItems": "2"
    },
    {
     "code": "landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable desktop landing page",
     "detail": "Update your website or landing page URL to enable access from desktop devices",
     "documentation": "https://support.google.com/merchants/answer/6098155",
     "numItems": "5"
    },
    {
     "code": "missing_condition_microdata",
     "servability": "unaffected",
     "resolution": "merchant_action",
     "description": "Missing or invalid data [condition]",
     "detail": "Add valid structured data markup to your landing page",
     "documentation": "https://support.google.com/merchants/answer/6183460",
     "numItems": "5"
    },
    {
     "code": "mobile_landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable mobile landing page",
     "detail": "Update your website or landing page URL to enable access from mobile devices",
     "documentation": "https://support.google.com/merchants/answer/6098296",
     "numItems": "3"
    }
   ]
  }
 ]
}

accountstatuses.list

Anda dapat menggunakan accountstatuses.list untuk melihat informasi status akun di semua sub-akun MCA Anda.

Anda dapat menggunakan filter dengan accountstatuses.list untuk memfilter masalah produk berdasarkan tujuan. Jika tujuan tidak ditentukan, respons akan menyertakan status untuk destination: Shopping.

Berikut adalah contoh permintaan guna mendapatkan informasi status akun untuk semua sub-akun berdasarkan merchantId MCA:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses

Berikut adalah contoh respons:

{
 "kind": "content#accountstatusesListResponse",
 "resources": [
  {
   "kind": "content#accountStatus",
   "accountId": "1234567",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "editorial_and_professional_standards_destination_url_down_policy",
     "title": "Account suspended due to policy violation: landing page not working",
     "country": "US",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  },
  {
   "kind": "content#accountStatus",
   "accountId": "123456789",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "home_page_issue",
     "title": "Website URL not provided",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/176793"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  }
 ]
}

Panggilan ke accountstatuses.list untuk akun non-MCA (misalnya, akun Merchant Center mandiri) akan menampilkan error 403.

Berikut contoh respons dalam memanggil accountstatuses.list untuk akun mandiri:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "forbidden",
    "message": "111111111 is not a multi-client account (MCA). The only account
                service operations allowed on non-MCAs are 'get', 'update',
                'authinfo' and 'claimwebsite'."
   }
  ],
  "code": 403,
  "message": "111111111 is not a multi-client account (MCA). The only account
              service operations allowed on non-MCAs are 'get', 'update',
              'authinfo' and 'claimwebsite'."
 }
}

Mode batch

accountstatuses.custombatch dengan metode GET menampilkan informasi status akun untuk beberapa sub-akun dalam akun multiklien.

JSON permintaan mencakup merchantId nomor akun MCA, accountId sub-akun, batchId unik, dan method yang ditetapkan ke get.

POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

Berikut adalah contoh isi JSON permintaan:

{
  "entries": [
    {
      "accountId": 1212121212,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 9
    },
    {
      "accountId": 1313131313,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 99
    }
  ]
}

Berikut adalah contoh isi respons JSON:

{
 "kind": "content#accountstatusesCustomBatchResponse",
 "entries": [
  {
   "batchId": 9,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1212121212",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "home_page_issue",
      "title": "Website URL not provided",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/176793"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  },
  {
   "batchId": 99,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1313131313",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "editorial_and_professional_standards_destination_url_down_policy",
      "title": "Account suspended due to policy violation: landing page not working",
      "country": "US",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  }
 ]
}

Menguji resource Status Akun

Pada contoh berikut, kita mendapatkan, mencantumkan, dan custombatch.get status akun untuk akun MCA:

Dapatkan status sub-akun untuk MCA menggunakan accountstatuses.get.
1. Dapatkan merchantId dan accountId dengan menjalankan GET ke endpoint API:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. Anda akan menerima kode status HTTP 200 untuk berhasil dan daftar status akun di JSON.
Lihat semua status sub-akun untuk MCA menggunakan accountstatuses.list.
1. Lakukan GET ke endpoint API dengan merchantId Anda:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
```
2. Anda akan menerima kode status HTTP 200 untuk berhasil dan daftar status akun di JSON untuk merchantId yang dikirimkan.
Lihat beberapa sub-akun untuk MCA dalam mode batch menggunakan accountstatuses.custombatch.
1. Buat JSON yang valid menggunakan accountID, merchant ID, dan metode get.
2. Lakukan POST ke endpoint API:
```
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
```
3. Anda akan menerima kode status HTTP 200 untuk berhasil dan daftar status akun di JSON.