Method: locations.searchkeywords.impressions.monthly.list

Zwraca słowa kluczowe użyte do znalezienia firmy w wyszukiwarce lub na mapach. Każdemu słowu kluczowemu w sieci wyszukiwania towarzyszą wyświetlenia liczone 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

string

Wymagane. Lokalizacja, dla której ma zostać pobrany ciąg czasowy. Format: lokalizacje/{locationId}, gdzie identyfikator lokalizacji to niezaciemniony identyfikator wizytówki.

Parametry zapytania

Parametry
monthlyRange

object (MonthlyRange)

Wymagane. Zakres miesięcy, w którym są zbierane wyświetlenia słów kluczowych w sieci wyszukiwania.
pageSize

integer

Opcjonalnie: Liczba żądanych wyników. Domyślny rozmiar strony to 100. Rozmiar strony może wynosić maksymalnie 100.
pageToken

string (bytes format)

Opcjonalnie: Token wskazujący następny wynik podzielony na strony, który ma zostać zwrócony.

Ciąg zakodowany w formacie base64.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Reprezentuje odpowiedź dla elementu month.list.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Pola
searchKeywordsCounts[]

object (SearchKeywordCount)

Wyszukiwane hasła użyte do znalezienia firmy.
nextPageToken

string (bytes format)

Token wskazujący ostatni zwrócony wynik z podziałem na strony. Może to być używane w przypadku kolejnych żądań przejścia na następną „stronę” słów kluczowych. Ta wartość będzie widoczna tylko wtedy, gdy jest więcej wyników do zwrócenia.

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ęczny (włącznie).

Zapis JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Pola
startMonth

object (Date)

Wymagane. Uwzględnione – uwzględniane będą tylko pola „rok i miesiące”
endMonth

object (Date)

Wymagane. Uwzględnione – uwzględniane będą tylko pola „rok i miesiące”

SearchKeywordCount

Reprezentuje pojedyncze słowo kluczowe w sieci wyszukiwania i jego wartość.

Zapis JSON 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Pola
searchKeyword

string

Ciąg pisany małymi literami wpisany przez użytkownika.
insightsValue

object (InsightsValue)

Jedna z tych możliwości: 1) Suma liczby unikalnych użytkowników, którzy używali 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ść statystyk.

Zapis JSON 
{

  // Union field InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
Pola
Pole sumy InsightsValue. Oznacza, że musi być obecne tylko jedno z poniższych pól proto. InsightsValue może mieć tylko jedną z tych wartości:
value

string (int64 format)

Reprezentuje rzeczywistą wartość.
threshold

string (int64 format)

Reprezentuje próg, poniżej którego spada rzeczywista wartość.