Stan konta

Za pomocą accountstatuses zasobów, by sprawdzić stan Twojego sprzedawcy konto Centrum lub MCA (multikonto klientów) i wszystkie powiązane subkonta z nim.

sprzedawców, którzy mają wiele sklepów internetowych lub marek, które są sprzedawane w osobnych sklepach witryny mogą mieć subkonto w ramach multikonta klientów.

Sprzedawcy są odpowiedzialni za przestrzeganie zasad Zakupów Google reklam i bezpłatnej informacji o produktach. Google Usługa Zakupy Google zastrzega sobie prawo do egzekwowania tych zasad i odpowiedniego reagowania na nie jeśli zauważymy treści lub zachowania, które naruszają te zasady.

Zobacz materiały referencyjne Problemy związane z kontem w celu uzyskania szczegółowych informacji na temat typowych problemów z kontem.

accountstatuses.get

W usłudze accountstatuses.get możesz wyświetlać informacje o stanie konta: jednego konta sprzedawcy.

Za pomocą parametru destination możesz określić, które problemy z produktem . Jeśli nie podasz miejsca docelowego, domyślna odpowiedź będzie zawierać ciąg statusy dotyczące usługi destination: Shopping.

Oto przykładowe żądanie, w którym merchantId to identyfikator konta MCA accountId jest subkontem tego multikonta klientów:

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

Aby uzyskać informacje o stanie samodzielnego konta, zadzwoń pod numer accountstatuses.get z tym samym identyfikatorem konta merchantId i accountId.

Ta metoda zwraca problemy na poziomie konta i produktu. Za pomocą instrukcji Zakupów Google ads i Bezpłatne informacje – zasoby do naprawienia Element accountLevelIssues został zwrócony w odpowiedzi od użytkownika accountstatuses.get.

Oto przykładowa odpowiedź dotycząca subkonta, które zostało zawieszone z powodu błędu strona nie działa” naruszenie zasad.

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

Za pomocą accountstatuses.list możesz wyświetlać informacje o stanie konta dotyczące wszystkich subkont MCA.

Za pomocą filtrów z atrybutem accountstatuses.list możesz filtrować problemy z produktami według miejsce docelowe. Jeśli nie podasz miejsca docelowego, odpowiedź będzie zawierać stany dla destination: Shopping.

Oto przykładowa prośba o uzyskanie informacji o stanie wszystkich subkont w ramach multikonta klientów merchantId:

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

Oto przykładowa odpowiedź:

{
 
"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"
     
}
   
}
   
]
 
}
 
]
}

wywołanie accountstatuses.list w przypadku konta innego niż MCA (np. samodzielnego konta Merchant Center) zwraca błąd 403.

Oto przykładowa odpowiedź na wywołanie funkcji accountstatuses.list w przypadku samodzielnego działania konto:

{
 
"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'."
 
}
}

Tryb wsadowy

Metoda accountstatuses.custombatch z metodą GET zwraca konto informacje o stanie wielu subkont na multikoncie klientów.

Plik JSON żądania zawiera merchantId numeru konta MCA, accountId subkonta, unikalne batchId i method ustawione na get.

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

Oto przykładowa treść JSON żądania:

{
 
"entries": [
   
{
     
"accountId": 1212121212,
     
"merchantId": 4444444444,
     
"method": "get",
     
"batchId": 9
   
},
   
{
     
"accountId": 1313131313,
     
"merchantId": 4444444444,
     
"method": "get",
     
"batchId": 99
   
}
 
]
}

Poniżej znajdziesz przykładową treść odpowiedzi 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"
     
}
     
}
   
]
   
}
 
}
 
]
}

Testowanie zasobu Stan konta

W poniższym przykładzie podajemy stan konta użytkownika custombatch.get i wyświetlamy listę Konta MCA:

  1. Sprawdzanie stanu subkonta MCA za pomocą usługi accountstatuses.get.

    1. Uzyskuj merchantId i accountId, wykonując w interfejsie API polecenie GET punkt końcowy:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
    2. Otrzymasz kod stanu HTTP 200 oznaczający powodzenie, a konto z listą stanów w formacie JSON.

  2. Wyświetl stan wszystkich subkont MCA korzystających z accountstatuses.list.

    1. Wykonaj operację GET do punktu końcowego API za pomocą merchantId:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
    2. Otrzymasz kod stanu HTTP 200 oznaczający powodzenie, a konto listę stanów w formacie JSON dla przesłanych danych merchantId.

  3. Wyświetl wiele subkont MCA w trybie wsadowym przy użyciu accountstatuses.custombatch

    1. Utwórz prawidłowy plik JSON za pomocą właściwości accountID, merchant ID i get .

    2. Wykonaj czynność POST do punktu końcowego interfejsu API:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
    3. Otrzymasz kod stanu HTTP 200 oznaczający powodzenie, a konto z listą stanów w formacie JSON.