Halaman ini diterjemahkan oleh Cloud Translation API.

Status akun

Anda dapat menggunakan referensi 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 dalam MCA.

Penjual bertanggung jawab untuk mematuhi kebijakan iklan Shopping dan listingan gratis. Google Shopping berhak menerapkan kebijakan ini dan merespons dengan tepat jika kami menemukan konten atau perilaku yang melanggar kebijakan ini.

Lihat referensi Masalah akun untuk mengetahui detail masalah akun umum.

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 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 untuk akun mandiri, panggil accountstatuses.get dengan ID akun yang sama untuk merchantId dan accountId.

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

Berikut adalah 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 menurut tujuan. Jika tujuan tidak ditentukan, respons akan menyertakan status untuk destination: Shopping.

Berikut adalah contoh permintaan untuk mendapatkan informasi status akun untuk semua sub-akun di bawah 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 adalah contoh respons untuk 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 menyertakan 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

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

Dapatkan status sub-akun untuk MCA menggunakan accountstatuses.get.
1. Dapatkan merchantId dan accountId dengan melakukan GET ke endpoint API:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. Anda akan menerima kode status HTTP 200 untuk keberhasilan dan daftar status akun dalam 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 keberhasilan dan daftar status akun dalam JSON untuk merchantId yang dikirimkan.
Melihat beberapa sub-akun untuk MCA dalam mode batch menggunakan accountstatuses.custombatch.
1. Buat JSON yang valid menggunakan metode accountID, merchant ID, dan 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 keberhasilan dan daftar status akun dalam JSON.