Method: locations.searchkeywords.impressions.monthly.list

검색 또는 지도에서 업체를 찾는 데 사용된 검색 키워드를 반환합니다. 각 검색 키워드에는 월 단위로 집계되는 노출수가 수반됩니다.

요청 예: 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

HTTP 요청

GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 시계열을 가져와야 하는 위치입니다. 형식: locations/{locationId}, 여기서 locationId는 난독화되지 않은 비즈니스 정보 ID입니다.

쿼리 매개변수

매개변수
monthlyRange

object (MonthlyRange)

필수 항목입니다. 검색 키워드 노출수를 집계할 월 단위의 범위입니다.

pageSize

integer

선택사항입니다. 요청된 결과의 수입니다. 기본 페이지 크기는 100입니다. 페이지 크기는 최대 100까지 설정할 수 있습니다.

pageToken

string (bytes format)

선택사항입니다. 페이지로 나눈 다음 결과를 반환할 토큰입니다.

base64 인코딩 문자열입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

monthly.list에 대한 응답을 나타냅니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
필드
searchKeywordsCounts[]

object (SearchKeywordCount)

비즈니스를 찾는 데 사용된 검색어입니다.

nextPageToken

string (bytes format)

마지막으로 페이지를 매긴 결과가 반환된 결과를 나타내는 토큰입니다. 이는 다음 '페이지'를 가져오기 위한 성공적인 요청에서 사용할 수 있습니다. 키워드 개수 더 많은 결과를 반환할 때만 표시됩니다.

base64 인코딩 문자열입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

MonthlyRange

월 범위를 나타내는 시간 범위입니다 (둘 다 포함).

JSON 표현
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
필드
startMonth

object (Date)

필수 항목입니다. 포함 - 연도와 월 필드만 고려

endMonth

object (Date)

필수 항목입니다. 포함 - 연도와 월 필드만 고려

SearchKeywordCount

단일 검색 키워드와 그 값을 나타냅니다.

JSON 표현
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
필드
searchKeyword

string

사용자가 입력한 소문자 문자열입니다.

insightsValue

object (InsightsValue)

다음 중 하나: 1) 한 달 동안 키워드를 사용한 순 사용자 수의 합계로, 요청된 각 월에 대해 집계됩니다. 2) 실제 값이 이 임계값 미만임을 나타내는 임계값

InsightsValue

통계 값을 나타냅니다.

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.
}
필드
통합 필드 InsightsValue. 다음 proto 필드 중 하나만 있어야 함을 나타냅니다. InsightsValue은 다음 중 하나여야 합니다.
value

string (int64 format)

실제 값을 나타냅니다.

threshold

string (int64 format)

실제 값이 속하는 임계값을 나타냅니다.