前提条件
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
要成功创建您的第一个客户端应用,您必须满足以下前提条件:
- 获取 Google 账号。
- 试用商家资料。
- 在 Google API 控制台中创建项目。
- 创建组织账号。
- 请求对该 API 的访问权限。
获取 Google 账号
您必须拥有 Google 账号才能在 Google API 控制台中创建项目。如果您已拥有一个账号,则无需进行任何操作。
试用商家资料
本 API 文档假定您之前使用过商家资料,并且熟悉网络编程概念和网络数据格式。
如果您还没有使用过商家资料,请先尝试使用界面,然后再开始编码。
在 Google API 控制台中创建项目
在向 Business Profile API 发送请求之前,您需要先使用 Google API 控制台创建项目,然后为该项目请求对 Business Profile API 的访问权限。要创建新项目,请前往 Google API 控制台。点击创建项目,输入名称,然后点击创建。
创建组织账号
如需创建组织账号,请参阅 GBP 帮助中心。
请求对这些 API 的访问权限
要启用您的项目并访问这些 API,您必须完成以下步骤:
- 转到 Google API 控制台,然后选择您创建的用于商家资料的项目。
- 若要确定项目 ID,请查看项目 ID 列。
- 现在应通过我们的 GBP API 联系表单提出 API 访问权限申请。请从下拉菜单中选择“Application for Basic API Access”(基本 API 访问权限申请),并提供请求的信息。
- 在您的申请审核完成后,我们会向您发送一封跟进电子邮件。
- 获批后,请参阅基本设置,以便为您的项目启用 Business Profile API。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\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."]]