- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- MonthlyRange (Zakres miesięcy)
- SearchKeywordCount
- InsightsValue
Wyświetla słowa kluczowe użyte do znalezienia firmy w wyszukiwarce lub na mapach. Każdemu słowu kluczowemu w sieci wyszukiwania towarzyszy liczba wyświetleń, które są agregowane co miesiąc.
Przykładowe żądanie: GET
https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthlyRange.start_month.year=2022&monthlyRange.start_month.month=1&monthlyRange.end_month.year=2022&monthlyRange.end_month.month=3
Żądanie HTTP
GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
To pole jest wymagane. Lokalizacja, dla której ma zostać pobrany ciąg czasowy. Format: lokalizacje/{locationId}, gdzie locationId to niezaciemniony identyfikator oferty. |
Parametry zapytania
Parametry | |
---|---|
monthlyRange |
To pole jest wymagane. Zakres (w miesiącach), w którym zebrane są wyświetlenia dla słów kluczowych w sieci wyszukiwania. |
pageSize |
Opcjonalnie. Liczba żądanych wyników. Domyślny rozmiar strony to 100. Maksymalny rozmiar strony to 100. |
pageToken |
Opcjonalnie. Token wskazujący, że zostanie zwrócony następny wynik podzielony na strony. Ciąg zakodowany w formacie base64. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Reprezentuje odpowiedź dla pola monthly.list.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"searchKeywordsCounts": [
{
object ( |
Pola | |
---|---|
searchKeywordsCounts[] |
Wyszukiwane hasła, które zostały użyte do znalezienia firmy. |
nextPageToken |
Token wskazujący ostatni zwrócony wynik z podziałem na strony. Można to wykorzystać, gdy żądania zostaną spełnione, aby wyświetlić następną „stronę” słów kluczowych. Będzie on widoczny tylko wtedy, gdy pojawi się więcej wyników. Ciąg zakodowany w formacie base64. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/business.manage
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
MonthlyRange
Zakres czasowy wskazujący zakres miesięcy (włącznie).
Zapis JSON |
---|
{ "startMonth": { object ( |
Pola | |
---|---|
startMonth |
To pole jest wymagane. Integracja – pod uwagę brane są tylko pola roku i miesięcy |
endMonth |
To pole jest wymagane. Integracja – pod uwagę brane są tylko pola roku i miesięcy |
SearchKeywordCount
Reprezentuje jedno wyszukiwane słowo kluczowe i jego wartość.
Zapis JSON |
---|
{
"searchKeyword": string,
"insightsValue": {
object ( |
Pola | |
---|---|
searchKeyword |
Ciąg znaków zapisany małymi literami, wpisany przez użytkownika. |
insightsValue |
1 z jednej z tych opcji: 1) Łączna liczba unikalnych użytkowników, którzy użyli słowa kluczowego w ciągu miesiąca, agregowana dla każdego żądanego miesiąca. 2) Próg, który wskazuje, że rzeczywista wartość jest poniżej tego progu. |
InsightsValue
Reprezentuje wartość obserwacji.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy InsightsValue . Informuje, że musi być obecne tylko jedno z tych pól proto. InsightsValue może mieć tylko jedną z tych wartości: |
|
value |
Reprezentuje faktyczną wartość. |
threshold |
Reprezentuje próg, poniżej którego wynosi rzeczywista wartość. |