검색 또는 지도에서 비즈니스를 찾는 데 사용된 검색 키워드를 반환합니다. 각 검색 키워드에는 월 단위로 집계되는 노출수가 수반됩니다.
요청 예시: 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 |
필수 항목입니다. 시계열을 가져와야 하는 위치입니다. 형식: locations/{locationId}, 여기서 locationId는 난독화되지 않은 비즈니스 정보 ID입니다. |
쿼리 매개변수
매개변수 | |
---|---|
monthlyRange |
필수 항목입니다. 검색 키워드 노출수를 집계할 개월 범위입니다. |
pageSize |
선택사항입니다. 요청된 결과 수입니다. 기본 페이지 크기는 100입니다. 페이지 크기는 최대 100까지 설정할 수 있습니다. |
pageToken |
선택사항입니다. 페이지로 나눈 다음 결과를 나타내는 토큰입니다. base64 인코딩 문자열입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
monthly.list에 대한 응답을 나타냅니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"searchKeywordsCounts": [
{
object ( |
필드 | |
---|---|
searchKeywordsCounts[] |
비즈니스를 찾는 데 사용된 검색어입니다. |
nextPageToken |
마지막으로 페이지로 나눈 결과를 나타내는 토큰입니다. 이 값은 키워드의 다음 '페이지'를 가져오기 위한 이후 요청에서 사용할 수 있습니다. 반환할 결과가 더 있는 경우에만 표시됩니다. base64 인코딩 문자열입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/business.manage
자세한 내용은 OAuth 2.0 개요를 참고하세요.
MonthlyRange
월 범위를 나타내는 시간 범위입니다 (둘 다 포함).
JSON 표현 |
---|
{ "startMonth": { object ( |
필드 | |
---|---|
startMonth |
필수 항목입니다. 포함 - 연도와 월 필드만 고려 |
endMonth |
필수 항목입니다. 포함 - 연도와 월 필드만 고려 |
SearchKeywordCount
단일 검색 키워드와 해당 값을 나타냅니다.
JSON 표현 |
---|
{
"searchKeyword": string,
"insightsValue": {
object ( |
필드 | |
---|---|
searchKeyword |
사용자가 입력한 소문자 문자열입니다. |
insightsValue |
다음 중 하나: 1) 한 달 동안 키워드를 사용한 순 사용자 수의 합계로, 요청된 각 달에 대해 집계됩니다. 2) 실제 값이 이 임계값 미만임을 나타내는 임계값 |
InsightsValue
통계 값을 나타냅니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 InsightsValue . 다음 proto 필드 중 하나만 있어야 함을 나타냅니다. InsightsValue 은 다음 중 하나여야 합니다. |
|
value |
실제 값을 나타냅니다. |
threshold |
실제 값이 속하는 임계값을 나타냅니다. |