Interfejs Search Console API oferuje te usługi:
- Analityka wyszukiwania – zapytania o dane dotyczące ruchu w witrynie.
- Mapy witryn – możesz wyświetlić listę wszystkich swoich map witryn, poprosić o informacje o konkretnej mapie witryny i przesłać ją do Google.
- Witryny – wyświetlanie, dodawanie i usuwanie usług na koncie Search Console.
- Sprawdzenie adresu URL – pozwala sprawdzić stan strony w indeksie Google (odpowiednik narzędzia do sprawdzania adresów URL w Search Console).
Analityka wyszukiwania
Szczegóły zasobu Analityka wyszukiwania znajdziesz na stronie Reprezentacja zasobu.
| Metoda | Żądanie HTTP | Opis |
|---|---|---|
| Identyfikatory URI są ustawiane względem adresu https://www.googleapis.com/webmasters/v3, o ile nie wskazano inaczej. | ||
| zapytanie |
POST /sites/siteUrl/searchAnalytics/query
|
Wyszukiwanie danych dotyczących ruchu w sieci wyszukiwania za pomocą zdefiniowanych przez Ciebie filtrów i parametrów. Zwraca ona 0 lub więcej wierszy zgrupowanych według zdefiniowanych przez Ciebie kluczy wierszy (wymiarów). Musisz zdefiniować zakres dat obejmujący co najmniej jeden dzień. Jeśli jednym z wymiarów jest data, wszystkie dni bez danych są pomijane na liście wyników. Aby dowiedzieć się, dla których dni są dostępne dane, wyślij zapytanie bez filtrów pogrupowanych według daty i dla wybranego zakresu dat. Wyniki są sortowane malejąco według liczby kliknięć. Jeśli 2 wiersze mają taką samą liczbę kliknięć, są one sortowane w dowolny sposób. Zapoznaj się z przykładem języka Python na temat wywoływania tej metody. Przykład żądania POST JSON:
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query
{
"startDate": "2015-04-01",
"endDate": "2015-05-01",
"dimensions": ["country","device"]
} |
Mapy witryn
Szczegółowe informacje o zasobach map witryn znajdziesz na stronie reprezentowania zasobów.
| Metoda | Żądanie HTTP | Opis |
|---|---|---|
| Identyfikatory URI są ustawiane względem adresu https://www.googleapis.com/webmasters/v3, o ile nie wskazano inaczej. | ||
| usuń |
DELETE /sites/siteUrl/sitemaps/feedpath
|
Usuwa mapę witryny. |
| pobierz |
GET /sites/siteUrl/sitemaps/feedpath
|
Pobiera informacje o konkretnej mapie witryny. |
| list |
GET /sites/siteUrl/sitemaps
|
Zawiera listę wpisów o mapach witryn przesłanych w przypadku tej witryny lub zawartych w pliku indeksu map witryny (jeśli w żądaniu określono sitemapIndex).
|
| prześlij |
PUT /sites/siteUrl/sitemaps/feedpath
|
Przesyła mapę witryny. |
Witryny
Szczegółowe informacje o zasobach w Witrynach znajdziesz na stronie Reprezentacja zasobu.
| Metoda | Żądanie HTTP | Opis |
|---|---|---|
| Identyfikatory URI są ustawiane względem adresu https://www.googleapis.com/webmasters/v3, o ile nie wskazano inaczej. | ||
| dodaj |
PUT /sites/siteUrl
|
Dodaje witrynę do zestawu witryn użytkownika w Search Console. |
| usuń |
DELETE /sites/siteUrl
|
Usuwa witrynę z zestawu witryn użytkownika w Search Console. |
| pobierz |
GET /sites/siteUrl
|
Pobiera informacje o określonej witrynie. |
| list |
GET /sites
|
Wyświetla listę witryn Search Console użytkownika. |
Sprawdzenie adresu URL
Szczegółowe informacje o zasobach do narzędzia do sprawdzania adresów URL znajdziesz na stronie reprezentowania zasobu.
| Metoda | Żądanie HTTP | Opis |
|---|---|---|
| Identyfikator URI względem https://searchconsole.googleapis.com/v1 | ||
| index.inspect |
POST /urlInspection/index:inspect
|
Informacje o podanym adresie URL w indeksie Google. Przykład żądania POST JSON:
POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect
{
"inspectionUrl": "https://www.example.com/mypage",
"siteUrl": "https://www.example.com/",
"languageCode": "en-US"} |