Możesz użyć zasobu accountstatuses
, aby sprawdzić stan konta Merchant Center lub multikonta klientów (multikonta klientów) i wszystkich powiązanych z nim subkont.
Sprzedawcy, którzy mają wiele sklepów internetowych lub marek, które sprzedajesz w osobnych witrynach, mogą zdecydować się na stosowanie subkont w ramach multikonta klientów.
Sprzedawcy są odpowiedzialni za przestrzeganie zasad dotyczących reklam produktowych i bezpłatnych informacji. Usługa Zakupy Google zastrzega sobie prawo do egzekwowania tych zasad i odpowiedniego reagowania, jeśli zauważymy treści lub zachowania, które naruszają te zasady.
Szczegółowe informacje o typowych problemach z kontem znajdziesz w artykule Problemy związane z kontem.
accountstatuses.get
Za pomocą accountstatuses.get
możesz wyświetlać informacje o stanie konta jednego sprzedawcy.
Za pomocą parametru destination
możesz określić, które problemy z produktami mają być zwracane. Jeśli miejsce docelowe nie jest określone, domyślna odpowiedź zawiera stany destination: Shopping
.
Oto przykładowe żądanie, w którym merchantId
to identyfikator konta MCA, a accountId
to subkonto 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. Możesz skorzystać z zasobów reklam produktowych i bezpłatnych informacji, aby naprawić błąd accountLevelIssues
zwrócony w odpowiedzi z accountstatuses.get
.
Oto przykładowa odpowiedź dotycząca subkonta, które zostało zawieszone z powodu naruszenia zasad dotyczących „niedziałającej strony docelowej”.
{
"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 wszystkich subkont w ramach multikonta klientów.
Za pomocą filtrów z atrybutem accountstatuses.list
możesz filtrować problemy z produktami według miejsca docelowego. Jeśli miejsce docelowe nie jest określone, odpowiedź zawiera stany destination: Shopping
.
Oto przykładowa prośba o uzyskanie informacji o stanie konta w przypadku 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 metody accountstatuses.list
w przypadku samodzielnego konta:
{
"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 informacje o stanie wielu subkont należących do multikonta klientów.
Plik JSON żądania zawiera merchantId
numeru konta MCA, accountId
subkonta, unikalny batchId
i method
ustawiony jako 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 pokazujemy w przypadku kont MCA stan konta Merchant Center „Pobieranie”, „Wyświetlenie listy” i „custombatch.get
”:
Sprawdzanie stanu subkonta MCA za pomocą usługi
accountstatuses.get
.Uzyskaj
merchantId
iaccountId
, wykonującGET
do punktu końcowego API:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Otrzymasz kod stanu
HTTP 200
oznaczający powodzenie i listę stanów konta w formacie JSON.
Wyświetlanie stanu wszystkich subkont multikonta klientów za pomocą funkcji
accountstatuses.list
.Wykonaj operację GET do punktu końcowego API za pomocą
merchantId
:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Otrzymasz kod stanu
HTTP 200
oznaczający powodzenie i listę stanów konta w formacie JSON dla przesłanych danychmerchantId
.
Wyświetl wiele subkont MCA w trybie wsadowym przy użyciu
accountstatuses.custombatch
.Utwórz prawidłowy plik JSON za pomocą metody
accountID
,merchant ID
iget
.Wykonaj czynność POST do punktu końcowego interfejsu API:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Otrzymasz kod stanu
HTTP 200
oznaczający powodzenie i listę stanów konta w formacie JSON.