Puoi utilizzare la risorsa accountstatuses
per visualizzare lo stato del tuo account Merchant Center o di un AMC (account multi-cliente) e di tutti i subaccount associati.
I commercianti con più negozi online o brand venduti su siti web distinti possono scegliere di avere subaccount all'interno di un AMC.
I commercianti sono tenuti a rispettare le norme relative agli annunci Shopping e alle schede senza costi. Google Shopping si riserva il diritto di applicare queste norme e di rispondere in modo appropriato se individuiamo contenuti o comportamenti che violano queste norme.
Consulta la pagina di riferimento Problemi correlati all'account per i dettagli dei problemi comuni relativi all'account.
accountstatuses.get
Puoi utilizzare accountstatuses.get
per visualizzare le informazioni sullo stato di un
singolo account commerciante.
Puoi utilizzare il parametro destination
per controllare quali problemi del prodotto vengono restituiti. Quando non è specificata una destinazione, la risposta predefinita include
gli stati per destination: Shopping
.
Ecco una richiesta di esempio, in cui merchantId
è un ID account dell'AMC e
accountId
è un subaccount di questo AMC:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Per ottenere informazioni sullo stato dell'account per un account autonomo, chiama
accountstatuses.get
con lo stesso ID account per merchantId
e accountId
.
Questo metodo restituisce problemi a livello di account e articolo. Puoi utilizzare le risorse Annunci Shopping e Schede senza costi per correggere il problema accountLevelIssues
restituito nella risposta da accountstatuses.get
.
Ecco un esempio di risposta per un subaccount che è stato sospeso per una violazione "Pagina di destinazione non funzionante".
{
"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
Puoi utilizzare accountstatuses.list
per visualizzare le informazioni sullo stato dell'account su tutti
i subaccount del tuo AMC.
Puoi utilizzare i filtri con accountstatuses.list
per filtrare i problemi relativi ai prodotti in base alla destinazione. Quando non è specificata una destinazione, la risposta include gli stati
per destination: Shopping
.
Di seguito è riportato un esempio di richiesta per ottenere le informazioni sullo stato dell'account per tutti i subaccount
dell'AMC merchantId
:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Ecco un esempio di risposta:
{
"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"
}
}
]
}
]
}
Una chiamata all'elemento accountstatuses.list
per un account non AMC (ad esempio, un account Merchant Center autonomo) restituisce un errore 403
.
Ecco un esempio di risposta per chiamare accountstatuses.list
per un
account autonomo:
{
"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'."
}
}
Modalità batch
Un accountstatuses.custombatch
con un metodo GET
restituisce informazioni sullo stato dell'account per più subaccount in un account multi-cliente.
Il JSON della richiesta include il merchantId
del numero di account dell'AMC, il accountId
del subaccount, un batchId
univoco e il method
impostato su get
.
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Di seguito è riportato un corpo JSON di una richiesta di esempio:
{
"entries": [
{
"accountId": 1212121212,
"merchantId": 4444444444,
"method": "get",
"batchId": 9
},
{
"accountId": 1313131313,
"merchantId": 4444444444,
"method": "get",
"batchId": 99
}
]
}
Di seguito è riportato un esempio di corpo della risposta 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"
}
}
]
}
}
]
}
Testare la risorsa Stati degli account
Nell'esempio seguente, gli account AMC mostrano lo stato dell'account custombatch.get
, elencato in un elenco:
Ottieni lo stato di un subaccount per un AMC utilizzando
accountstatuses.get
.Recupera
merchantId
eaccountId
eseguendo unGET
all'endpoint API:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Dovresti ricevere un codice di stato
HTTP 200
per l'esito positivo e l'elenco dello stato dell'account in JSON.
Visualizza lo stato di tutti i subaccount di un AMC utilizzando
accountstatuses.list
.Esegui una richiesta GET all'endpoint API con il tuo
merchantId
:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Dovresti ricevere un codice di stato
HTTP 200
per l'esito positivo e l'elenco dello stato dell'account in JSON per ilmerchantId
inviato.
Visualizza più subaccount per l'AMC in modalità batch utilizzando
accountstatuses.custombatch
.Crea un file JSON valido utilizzando
accountID
,merchant ID
e un metodoget
.Esegui un POST sull'endpoint API:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Dovresti ricevere un codice di stato
HTTP 200
per l'esito positivo e l'elenco dello stato dell'account in JSON.