Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
기본 요건
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
첫 번째 클라이언트 애플리케이션을 만들려면 다음 기본 요건을 충족해야 합니다.
- Google 계정 만들기
- 비즈니스 프로필 사용해 보기
- Google API 콘솔에서 프로젝트 만들기
- 조직 계정 만들기
- API 액세스 요청하기
Google 계정 만들기
Google API
콘솔에서 프로젝트를 생성하려면 Google 계정이
필요합니다. 이미 계정이 있다면 준비가 된 것입니다.
비즈니스 프로필 사용해 보기
이 API 문서에서는 사용자가 이전에 비즈니스 프로필을 사용해 본 적이 있고 웹 프로그래밍 개념과 웹 데이터 형식에 익숙하다고 가정합니다.
비즈니스 프로필을 사용해 보지 않았다면 코딩을 시작하기 전에 사용자 인터페이스를 사용해 보세요.
Google API 콘솔에서 프로젝트 만들기
Business Profile API에 요청을 보내려면 Google API 콘솔을 사용하여 프로젝트를 만든 다음 해당 프로젝트의 Business Profile API에 대한 액세스 권한을 요청해야 합니다. 새 프로젝트를 만들려면 Google API 콘솔로 이동합니다.
프로젝트 만들기를 클릭하고 이름을 입력한 다음 만들기를 클릭합니다.
조직 계정 만들기
조직 계정을 만들려면
GBP 고객센터로 이동합니다.
API 액세스 요청하기
프로젝트를 사용 설정하고 API에 액세스하려면 다음 단계를 완료해야 합니다.
- Google API 콘솔로 이동하여 비즈니스 프로필에서 사용하기 위해 만든 프로젝트를 선택합니다.
- 프로젝트 ID를 알아보려면 프로젝트 ID 열을 확인합니다.
- 이제 GBP API 문의 양식을 사용하여 API 액세스를 신청해야 합니다. 드롭다운에서 '기본 API 액세스 신청'을 선택하고 요청된 정보를 제공하세요.
- 요청 검토가 완료되면 후속 이메일이 전송됩니다.
- 승인 후 프로젝트에 Business Profile API를 사용 설정하려면 기본 설정을 참고합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eYou need a Google Account and familiarity with Business Profile before starting.\u003c/p\u003e\n"],["\u003cp\u003eCreate a project in the Google API Console and an Organization account to access the API.\u003c/p\u003e\n"],["\u003cp\u003eRequest access to the Business Profile API via the GBP API contact form and await approval.\u003c/p\u003e\n"],["\u003cp\u003eEnable the Business Profile APIs for your project after receiving approval.\u003c/p\u003e\n"]]],[],null,["# Prerequisites\n\nTo successfully create your first client application, you must complete the following\nprerequisites:\n\n1. [Get a Google Account](#get-account).\n2. [Try out Business Profile](#try-out).\n3. [Create a project in the Google Cloud Console](#create-project).\n4. [Create an Organization account](#create-organization-account).\n5. [Request access to the API](#request-access).\n\nGet a Google Account\n--------------------\n\nYou need a\n[Google Account](https://www.google.com/accounts/NewAccount) in order to create a project in the\nGoogle API Console. If you already have an account, you're all set.\n\nTry out Business Profile\n------------------------\n\nThis API documentation assumes that you've used Business Profile before, and that you're\nfamiliar with web programming concepts and web data formats.\n\nIf you haven't used Business Profile, try out the\n[user interface](https://www.google.com/business/) before you start to code.\n\nCreate a project in the Google API Console\n------------------------------------------\n\nBefore you can send requests to the Business Profile APIs, you need to use the\nGoogle API Console to create a project, and then request access to the Business Profile APIs for that\nproject. To create a new project, go to the\n[Google Cloud Console](https://console.developers.google.com/project).\nClick **Create project** , enter a name, and click **Create**.\n\nCreate an Organization account\n------------------------------\n\nTo create an Organization account, go to the\n[GBP help center](https://support.google.com/business/answer/7663063).\n\nRequest access to the APIs\n--------------------------\n\nIn order to get access to GBP APIs, we require all applicants:\n\n- Manage a Google Business Profile that is verified and active for 60+ days. This GBP can be the applicant's own office or headquarters or it could belong to one of the clients they manage.\n- Have a website representing the business listed on the GBP.\n\nFor a smooth and timely review of your application, we recommend that the Google Business Profile is fully complete and kept up-to-date with the current business information, including the business's official website.\n\nOnce you have met the requirements stated earlier, you can request API access by following these steps:\n\n1. Go to the [Google Cloud Console](https://console.developers.google.com/project) and select the project you plan to use with the Business Profile APIs.\n2. Find your Project Number in the Project info card on your project's Dashboard. You will need to provide this number in your application.\n3. When you are ready, submit your request using our [GBP API contact form](https://support.google.com/business/contact/api_default). Select 'Application for Basic API Access' from the drop-down menu and provide all requested information.\n4. Make sure that you are using an email address that is listed as an owner/manager on your business's GBP.\n5. A follow-up email will be sent to you after your request has been reviewed.\n\n**Note on Checking Approval Status:** You can also check if your project has been approved by viewing the quotas for the Business Profile APIs in the Google Cloud Console.\n\n- If your quota is 0 QPM (Queries Per Minute), your project has not yet been approved.\n- If your quota is set to 300 QPM, your project is approved.\n\nIf your application is approved, see [Basic setup](/my-business/content/basic-setup) to enable the Business Profile APIs for your project. If your application is rejected, make sure you have met the requirements stated earlier before re-applying."]]