Status akun

Anda dapat menggunakan accountstatuses Referensi untuk melihat status Penjual Akun Google Center, atau MCA (akun multiklien) dan semua sub-akun yang terkait dengannya.

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

Penjual bertanggung jawab untuk mematuhi Persyaratan iklan dan gratis listingan kami. Kebijakan Privasi Shopping berhak menegakkan kebijakan ini dan merespons dengan sesuai 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 satu akun penjual.

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

Berikut 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

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

Metode ini akan menampilkan masalah tingkat akun dan item. Anda dapat menggunakan platform Shopping iklan dan Gratis listingan yang perlu diperbaiki accountLevelIssues yang ditampilkan sebagai respons dari accountstatuses.get.

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

{
 "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 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) menampilkan error 403.

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

{
 "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 akan menampilkan akun informasi status untuk beberapa sub-akun di akun multiklien.

JSON permintaan mencakup merchantId nomor akun MCA, yaitu accountId dari 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:

  1. Dapatkan status sub-akun untuk MCA menggunakan accountstatuses.get.

    1. Dapatkan merchantId dan accountId dengan menjalankan GET ke API endpoint:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
      
    2. Anda akan menerima kode status HTTP 200 untuk keberhasilan dan akun daftar status di JSON.

  2. 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 akun daftar status di JSON untuk merchantId yang dikirimkan.

  3. Lihat beberapa sub-akun untuk MCA dalam mode batch menggunakan accountstatuses.custombatch.

    1. Membuat JSON yang valid menggunakan 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 akun daftar status di JSON.