Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
必備條件
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如要順利建立第一個用戶端應用程式，請務必完成下列事前準備工作：
- 取得 Google 帳戶。
- 試用商家檔案。
- 在 Google Cloud 控制台中建立專案。
- 建立機構帳戶。
- 要求存取 API。
申請 Google 帳戶
您必須擁有 Google 帳戶，才能在 Google API 控制台中建立專案。如果已有帳戶，就可以開始使用了。
試用商家檔案
這份 API 說明文件假設您先前使用過商家檔案，也熟悉網路程式設計概念和網路資料格式。
如果您還沒用過商家檔案，請先試用使用者介面，再開始編寫程式碼。
在 Google API 控制台中建立專案
如要對商家檔案 API 發出要求，請先使用 Google API 控制台建立專案，然後為該專案要求商家檔案 API 的存取權。如要建立新專案，請前往 Google Cloud 控制台。
按一下「建立專案」，輸入名稱，然後按一下「建立」。
建立機構帳戶
如要建立機構帳戶，請前往 Google 商家檔案說明中心。
要求存取 API
如要取得 Google 商家檔案 API 的存取權，所有申請者都必須：
- 管理已通過驗證且啟用超過 60 天的 Google 商家檔案。這個 Google 商家檔案可以是申請人自己的辦公室或總部，也可以屬於他們管理的其中一位客戶。
- 擁有代表 Google 商家檔案中列出商家的網站。
為確保申請能順利及時通過審查，建議你完整填寫 Google 商家檔案，並隨時更新商家資訊，包括商家的官方網站。
符合上述條件後，請按照下列步驟要求 API 存取權：
- 前往 Google Cloud 控制台，然後選取要搭配商家檔案 API 使用的專案。
- 在專案資訊主頁的「專案資訊」資訊卡中，找出所需的專案編號。申請時必須提供此號碼。
- 準備就緒後，請使用 GBP API 聯絡表單提交要求。從下拉式選單中選取「Application for Basic API Access」(基本 API 存取權申請)，並提供所有要求資訊。
- 請務必使用商家 Google 商家檔案中列為擁有者/管理員的電子郵件地址。
- 要求審查完畢後，我們會傳送後續追蹤電子郵件。
注意：如何查看核准狀態：您也可以在 Google Cloud 控制台中查看商家檔案 API 的配額，確認專案是否已獲准。
- 如果配額為 0 QPM (每分鐘查詢次數)，表示專案尚未獲得核准。
- 如果配額設為 300 QPM，專案就會獲得核准。
如果應用程式獲得核准，請參閱基本設定，為專案啟用 Business Profile API。如果申請遭拒，請先確認是否符合上述規定，再重新申請。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-29 (世界標準時間)。
[null,null,["上次更新時間：2025-08-29 (世界標準時間)。"],[[["\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."]]
