Stato account

Puoi utilizzare la risorsa accountstatuses per visualizzare lo stato del tuo account Merchant Center o di un account multi-cliente (AMC) e di tutti i subaccount associati.

I commercianti che hanno più negozi online o brand venduti su siti web separati possono scegliere di avere subaccount in un AMC.

I commercianti sono responsabili del rispetto delle 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 rileva contenuti o comportamenti che le violano.

Per informazioni dettagliate sui problemi comuni relativi all'account, consulta il riferimento Problemi correlati all'account.

accountstatuses.get

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

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

Ecco una richiesta di esempio, in cui merchantId è un ID account AMC e accountId è un subaccount di quell'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 di articolo. Puoi utilizzare le risorse Annunci Shopping e Schede senza costi per correggere accountLevelIssues restituito nella risposta da accountstatuses.get.

Ecco una risposta di esempio per un subaccount sospeso per violazione relativa a una "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 in tutti i subaccount del tuo account multi-cliente.

Puoi utilizzare i filtri con accountstatuses.list per filtrare i problemi dei prodotti in base alla destinazione. Quando non viene specificata una destinazione, la risposta include gli stati per destination: Shopping.

Ecco una richiesta di esempio per ottenere informazioni sullo stato dell'account per tutti i subaccount dell'AMC merchantId:

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

Ecco una risposta di esempio:

{
 "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 a accountstatuses.list per un account non AMC (ad esempio, un account Merchant Center autonomo) restituisce un errore 403.

Ecco una risposta di esempio 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 merchantId del numero di account AMC, accountId del subaccount, un batchId univoco e method impostato su get.

POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

Di seguito è riportato un esempio di corpo JSON della richiesta:

{
  "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 Account Statuses

Nell'esempio seguente otteniamo, elenchiamo e custombatch.get lo stato dell'account per gli account multicliente:

  1. Ottieni lo stato del subaccount per un AMC utilizzando accountstatuses.get.

    1. Ottieni merchantId e accountId eseguendo una GET all'endpoint API:

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

    2. Dovresti ricevere un codice di stato HTTP 200 per l'operazione riuscita e l'elenco degli stati dell'account in formato JSON.

  2. 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'operazione riuscita e l'elenco degli stati dell'account in formato JSON per la richiesta merchantId inviata.

  3. Visualizza più subaccount per l'AMC in modalità batch utilizzando accountstatuses.custombatch.

    1. Crea un JSON valido utilizzando accountID, merchant ID e un metodo get.

    2. Esegui una richiesta POST all'endpoint API:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

    3. Dovresti ricevere un codice di stato HTTP 200 per l'operazione riuscita e l'elenco degli stati dell'account in formato JSON.