Method: locations.searchkeywords.impressions.monthly.list

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

string

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

object (MonthlyRange)

To pole jest wymagane. Zakres (w miesiącach), w którym zebrane są wyświetlenia dla słów kluczowych w sieci wyszukiwania.
pageSize

integer

Opcjonalnie. Liczba żądanych wyników. Domyślny rozmiar strony to 100. Maksymalny rozmiar strony to 100.
pageToken

string (bytes format)

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 (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Pola
searchKeywordsCounts[]

object (SearchKeywordCount)

Wyszukiwane hasła, które zostały użyte do znalezienia firmy.
nextPageToken

string (bytes format)

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 (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Pola
startMonth

object (Date)

To pole jest wymagane. Integracja – pod uwagę brane są tylko pola roku i miesięcy
endMonth

object (Date)

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 (InsightsValue)
  }
}
Pola
searchKeyword

string

Ciąg znaków zapisany małymi literami, wpisany przez użytkownika.
insightsValue

object (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 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. Informuje, że musi być obecne tylko jedno z tych pól proto. InsightsValue może mieć tylko jedną z tych wartości:
value

string (int64 format)

Reprezentuje faktyczną wartość.
threshold

string (int64 format)

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