Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
پیش‌نیازها
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برای ایجاد موفقیت آمیز اولین برنامه مشتری خود، باید پیش نیازهای زیر را تکمیل کنید:
- یک حساب Google دریافت کنید .
- نمایه کسب و کار را امتحان کنید .
- یک پروژه در Google Cloud Console ایجاد کنید .
- یک حساب سازمانی ایجاد کنید .
- درخواست دسترسی به API .
یک حساب Google دریافت کنید
برای ایجاد پروژه در Google API Console به یک حساب Google نیاز دارید. اگر از قبل یک حساب کاربری دارید، همه چیز آماده است.
نمایه کسب و کار را امتحان کنید
این مستندات API فرض می‌کند که قبلاً از نمایه کسب‌وکار استفاده کرده‌اید، و با مفاهیم برنامه‌نویسی وب و قالب‌های داده‌های وب آشنا هستید.
اگر از نمایه کسب‌وکار استفاده نکرده‌اید، قبل از شروع به کدنویسی، رابط کاربری را امتحان کنید.
یک پروژه در Google API Console ایجاد کنید
قبل از اینکه بتوانید درخواست‌هایی را به APIهای نمایه کسب‌وکار ارسال کنید، باید از کنسول API Google برای ایجاد یک پروژه استفاده کنید و سپس درخواست دسترسی به APIهای نمایه کسب‌وکار آن پروژه را بدهید. برای ایجاد یک پروژه جدید، به Google Cloud Console بروید. روی ایجاد پروژه کلیک کنید، یک نام وارد کنید و روی ایجاد کلیک کنید.
یک حساب سازمانی ایجاد کنید
برای ایجاد یک حساب سازمانی، به مرکز راهنمایی GBP بروید.
درخواست دسترسی به APIها
برای دسترسی به API های GBP، ما از همه متقاضیان می خواهیم:
- نمایه کسب و کار Google را مدیریت کنید که به مدت بیش از 60 روز تأیید شده و فعال است. این پوند می تواند دفتر یا دفتر مرکزی خود متقاضی باشد یا به یکی از مشتریانی که آنها مدیریت می کنند تعلق داشته باشد.
- وب سایتی داشته باشید که نشان دهنده کسب و کار فهرست شده در GBP باشد.
برای بررسی صاف و به موقع درخواست خود، توصیه می کنیم نمایه کسب و کار Google کاملاً کامل باشد و با اطلاعات کسب و کار فعلی، از جمله وب سایت رسمی کسب و کار، به روز باشد.
هنگامی که الزامات ذکر شده در ابتدا را برآورده کردید، می توانید با دنبال کردن مراحل زیر درخواست دسترسی API کنید:
- به Google Cloud Console بروید و پروژه ای را که قصد دارید با APIهای نمایه کسب و کار استفاده کنید، انتخاب کنید.
- شماره پروژه خود را در کارت اطلاعات پروژه در داشبورد پروژه خود پیدا کنید. شما باید این شماره را در برنامه خود وارد کنید.
- وقتی آماده شدید، درخواست خود را با استفاده از فرم تماس GBP API ما ارسال کنید. از منوی کشویی "Application for Basic API Access" را انتخاب کنید و تمام اطلاعات درخواستی را ارائه دهید.
- اطمینان حاصل کنید که از آدرس ایمیلی استفاده می‌کنید که به عنوان مالک/مدیر در GBP کسب و کار شما فهرست شده است.
- پس از بررسی درخواست شما یک ایمیل تکمیلی برای شما ارسال خواهد شد.
نکته در مورد بررسی وضعیت تأیید: همچنین می‌توانید با مشاهده سهمیه‌های API نمایه کسب‌وکار در Google Cloud Console بررسی کنید که آیا پروژه شما تأیید شده است.
- اگر سهمیه شما 0 QPM (پرس و جو در دقیقه) باشد، پروژه شما هنوز تایید نشده است.
- اگر سهمیه شما روی 300 QPM تنظیم شده باشد، پروژه شما تایید می شود.
اگر درخواست شما تأیید شد، برای فعال کردن API های نمایه کسب و کار برای پروژه خود، به تنظیمات اولیه مراجعه کنید. اگر درخواست شما رد شد، قبل از درخواست مجدد، مطمئن شوید که شرایطی را که قبلا ذکر شده بود، برآورده کرده اید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]
