Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는 
새로운 API 메서드가 있습니다.
 v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면 
지원 중단 일정 및 안내를 검토하세요.
  
        
 
       
     
  
  
  
    
  
  
  
    
      Method: googleLocations.search
    
    
      
    
    
      
      컬렉션을 사용해 정리하기
    
    
      
      내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
    
  
    
  
      
    
  
  
  
  
  
  
    
    
    
    
    
    
      
      
      
        지정된 요청과 일치하는 가능한 모든 위치를 검색합니다.
      
      
        
          HTTP 요청
          POST https://mybusiness.googleapis.com/v4/googleLocations:search
URL은 gRPC 트랜스코딩 구문을 사용합니다.
        
        
          요청 본문
          요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
          
            
              
                
                  | JSON 표현 | 
                
              
              
                
                  {
  "resultCount": integer,
  // Union field search_query can be only one of the following:
  "location": {
    object (Location)
  },
  "query": string
  // End of list of possible types for union field search_query.
} | 
                
              
            
          
          
            
              
                
                  | 필드 | 
                
              
              
                
                  resultCount | 
                  
                     integer 
                    반환할 일치 항목의 수입니다. 기본값은 3이며 최대 10입니다. 더 많이 요청되면 지연 시간이 늘어날 수 있습니다. 페이지로 나누기는 없습니다. 
                   | 
                
                
                  통합 필드 search_query. 검색어 위치 객체 또는 문자열 쿼리로 제공될 수 있습니다. search_query은 다음 중 하나여야 합니다. | 
                
                
                  location | 
                  
                     object (Location) 
                    검색할 위치입니다. 제공되는 경우 는 제공된 위치 세부정보와 일치하는 위치를 찾습니다. 
                   | 
                
                
                  query | 
                  
                     string 
                    검색할 텍스트 쿼리입니다. 검색어 문자열의 검색 결과는 정확한 위치를 제공하는 경우보다 정확도가 떨어질 수 있지만 부정확한 일치 결과는 더 많이 제공할 수 있습니다. 
                   | 
                
              
            
          
        
        
          응답 본문
          성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
          
            
              GoogleLocations.SearchGoogleLocations의 응답 메시지입니다.
            
            
            
              
                
                  
                    | 필드 | 
                  
                
                
                  
                    googleLocations[] | 
                    
                       object (GoogleLocation) 
                      지정된 요청과 일치할 가능성이 있는 GoogleLocations 컬렉션으로, 정확성이 가장 높은 것부터 순서대로 나열됩니다. 
                     | 
                  
                
              
            
          
        
        
          승인 범위
          다음 OAuth 범위 중 하나가 필요합니다.
          
            https://www.googleapis.com/auth/plus.business.manage 
            https://www.googleapis.com/auth/business.manage 
          
자세한 내용은 OAuth 2.0 개요를 참고하세요.
        
      
    
  
  
  
  
 
  
    
      
      
    
    
      
    
    
  
       
    
    
      
    
  
  
  달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
  최종 업데이트: 2025-07-25(UTC)
  
  
  
    
      [[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-25(UTC)"],[],["The core content describes searching for Google locations via a `POST` request to `https://mybusiness.googleapis.com/v4/googleLocations:search`.  The request body can include either a `location` object or a string `query` within the `search_query` field, plus an integer `resultCount`. The response body contains an array of `googleLocations`, representing potential matches ranked by accuracy.  Authorization requires either `plus.business.manage` or `business.manage` OAuth scopes.\n"]]