Questa pagina è stata tradotta dall'API Cloud Translation.

Stato account

Puoi utilizzare lo accountstatuses per vedere lo stato del tuo account Center o un AMC (account multi-cliente) e tutti i subaccount associati con essa.

Commercianti con più negozi online o brand venduti in diversi negozi i siti web possono scegliere di avere subaccount in un AMC.

I commercianti sono tenuti a rispettare le annunci e senza costi relative alle schede. Google Shopping si riserva il diritto di applicare queste norme e di rispondere in modo appropriato se rileviamo contenuti o comportamenti che violano queste norme.

Consulta il riferimento per i problemi relativi all'account per informazioni dettagliate sui problemi comuni dell'account.

accountstatuses.get

Puoi utilizzare accountstatuses.get per visualizzare le informazioni sullo stato dell'account per un un unico account commerciante.

Puoi utilizzare il parametro destination per controllare quali problemi relativi ai prodotti sono vengono restituiti. Se non viene specificata una destinazione, la risposta predefinita include stati di destination: Shopping.

Ecco una richiesta di esempio, in cui merchantId è un ID account dell'AMC e accountId è un subaccount di tale AMC:

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

Per ottenere le 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 la scheda Shopping annunci e Senza costi delle schede da correggere accountLevelIssues restituito nella risposta da accountstatuses.get.

Di seguito è riportato un esempio di risposta per un subaccount che è stato sospeso per una richiesta pagina non funzionante" per violazione delle norme.

{
 "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 subaccount del tuo AMC.

Puoi utilizzare i filtri con accountstatuses.list per filtrare i problemi relativi ai prodotti per destinazione. Quando non è specificata una destinazione, la risposta include gli stati per destination: Shopping.

Ecco un esempio di richiesta per ottenere informazioni sullo stato dell'account per tutti i subaccount nell'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 al 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 una sessione :

{
 "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 un account informazioni sullo stato di più subaccount in un account multi-cliente.

Il file JSON della richiesta include il merchantId del numero di conto bancario dell'AMC, accountId del subaccount, un batchId univoco e method impostati 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 si ottiene lo stato dell'account custombatch.get elenco e Account AMC:

Ottieni lo stato di un subaccount per un AMC utilizzando accountstatuses.get.
1. Ottieni merchantId e accountId eseguendo un GET all'API endpoint:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. Dovresti ricevere un codice di stato HTTP 200 per l'esito positivo e l'account dell'elenco di stati in JSON.
Visualizza lo stato di tutti i subaccount di un AMC utilizzando accountstatuses.list.
1. Esegui una richiesta GET all'endpoint API con il tuo merchantId:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
```
2. Dovresti ricevere un codice di stato HTTP 200 per l'esito positivo e l'account elenco degli stati in JSON per merchantId inviato.
Visualizza più subaccount per l'AMC in modalità batch utilizzando accountstatuses.custombatch.
1. Crea un JSON valido utilizzando accountID, merchant ID e un get .
2. Esegui un POST sull'endpoint API:
```
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
```
3. Dovresti ricevere un codice di stato HTTP 200 per l'esito positivo e l'account dell'elenco di stati in JSON.