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 dengan akun tersebut.

Penjual yang memiliki beberapa toko online atau merek yang dijual di situs terpisah dapat memilih untuk memiliki sub-akun di bawah 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 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 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 dari MCA tersebut:

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

Guna 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 referensi Iklan Shopping dan Listingan gratis untuk memperbaiki accountLevelIssues yang ditampilkan dalam respons dari accountstatuses.get.

Berikut ini 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 untuk mendapatkan informasi status akun untuk semua sub-akun dalam 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 guna 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 di 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 keberhasilan dan daftar status akun di JSON.
Lihat semua status sub-akun untuk MCA yang menggunakan accountstatuses.list.
1. Jalankan 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 di JSON untuk merchantId yang dikirim.
Lihat 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 di JSON.