accountstatuses
リソースを使用すると、Merchant Center アカウント、MCA(マルチクライアント アカウント)とそれに関連付けられているすべてのサブアカウントのステータスを確認できます。
複数のオンライン ショップや、別々のウェブサイトで販売されているブランドがある販売者は、MCA に基づくサブアカウントを持つことができます。
販売者は、ショッピング広告と無料リスティングに関するポリシーに準拠する責任を負います。Google ショッピングは、これらのポリシーを適用し、ポリシーに違反するコンテンツや行為が見つかった場合に適切に対応する権限を有します。
アカウントに関する一般的な問題について詳しくは、アカウントに関する問題のリファレンスをご覧ください。
accountstatuses.get
accountstatuses.get
を使用すると、単一の販売アカウントのアカウント ステータス情報を表示できます。
destination
パラメータを使用して、返されるプロダクトの問題を制御できます。デスティネーションが指定されていない場合、デフォルトのレスポンスには destination: Shopping
のステータスが含まれます。
次のサンプル リクエストでは、merchantId
が MCA アカウント ID、accountId
がその MCA のサブアカウントです。
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
スタンドアロン アカウントのアカウント ステータス情報を取得するには、merchantId
と accountId
に同じアカウント ID を使用して accountstatuses.get
を呼び出します。
このメソッドは、アカウント レベルと商品アイテムレベルの問題を返します。ショッピング広告リソースと無料リスティングリソースを使用して、accountstatuses.get
からのレスポンスで返される accountLevelIssues
を修正できます。
「ランディング ページが機能していない」という違反で強制停止されたサブアカウントに対するレスポンスの例を次に示します。
{
"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
accountstatuses.list
を使用すると、MCA のすべてのサブアカウントのアカウント ステータス情報を表示できます。
accountstatuses.list
を指定してフィルタを使用すると、プロダクトの問題を宛先でフィルタできます。デスティネーションが指定されていない場合、レスポンスには destination: Shopping
のステータスが含まれます。
以下は、MCA merchantId
のすべてのサブアカウントについて、アカウント ステータス情報を取得するリクエストの例です。
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
レスポンスの例を次に示します。
{
"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"
}
}
]
}
]
}
MCA 以外のアカウント(独立した Merchant Center アカウントなど)の accountstatuses.list
を呼び出すと、403
エラーが返されます。
スタンドアロン アカウントの accountstatuses.list
を呼び出した場合のレスポンス例を次に示します。
{
"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'."
}
}
バッチモード
GET
メソッドを持つ accountstatuses.custombatch
は、マルチクライアント アカウントの複数のサブアカウントのアカウント ステータス情報を返します。
リクエストの JSON には、MCA アカウント番号の merchantId
、サブアカウントの accountId
、一意の batchId
、get
に設定された method
が含まれます。
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
リクエストの JSON 本文の例を次に示します。
{
"entries": [
{
"accountId": 1212121212,
"merchantId": 4444444444,
"method": "get",
"batchId": 9
},
{
"accountId": 1313131313,
"merchantId": 4444444444,
"method": "get",
"batchId": 99
}
]
}
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"
}
}
]
}
}
]
}
アカウント ステータス リソースをテストする
次の例では、MCA アカウントのステータスを取得、一覧表示、custombatch.get
します。
accountstatuses.get
を使用して MCA のサブアカウントのステータスを取得します。API エンドポイントに対して
GET
を実行して、merchantId
とaccountId
を取得します。GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
成功の場合は
HTTP 200
ステータス コードと、JSON のアカウント ステータス リストが返されます。
accountstatuses.list
を使用して MCA のすべてのサブアカウントのステータスを表示する。merchantId
を使用して API エンドポイントへの GET を実行します。GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
成功の場合は
HTTP 200
ステータス コードと、送信されたmerchantId
の JSON のアカウント ステータス リストが返されます。
accountstatuses.custombatch
を使用して、バッチモードで MCA の複数のサブアカウントを表示します。accountID
、merchant ID
、get
メソッドを使用して、有効な JSON を作成します。API エンドポイントに対して POST を実行します。
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
成功の場合は
HTTP 200
ステータス コードと、JSON のアカウント ステータス リストが返されます。