تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
المتطلّبات الأساسية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لإنشاء تطبيق العميل الأول بنجاح، يجب استيفاء المتطلبات الأساسية التالية:
- الحصول على حساب Google
- تجربة "الملف التجاري على Google"
- أنشِئ مشروعًا في Google Cloud Console.
- أنشئ حساب مؤسسة.
- طلب الوصول إلى واجهة برمجة التطبيقات
الحصول على حساب Google
يجب أن يكون لديك حساب Google لإنشاء مشروع في Google API Console. إذا كان لديك حساب حالي، تكون قد انتهيت من عملية إعداد حسابك.
تجربة "الملف التجاري"
تفترض مستندات واجهة برمجة التطبيقات هذه أنّك استخدمت "الملف التجاري" من قبل، وأنّك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب.
إذا لم يسبق لك استخدام "الملف التجاري"، جرِّب واجهة المستخدم قبل البدء في كتابة الرموز.
إنشاء مشروع في Google API Console
قبل إرسال طلبات إلى واجهات برمجة تطبيقات "الملف التجاري على Google"، عليك استخدام
وحدة تحكّم Google API لإنشاء مشروع، ثم طلب الوصول إلى واجهات برمجة تطبيقات "الملف التجاري على Google" لهذا المشروع. لإنشاء مشروع جديد، انتقِل إلى Google Cloud Console.
انقر على إنشاء مشروع، وأدخِل اسمًا، ثم انقر على إنشاء.
إنشاء حساب مؤسسة
لإنشاء حساب مؤسسة، انتقِل إلى مركز مساعدة "نشاطي التجاري على Google".
طلب الوصول إلى واجهات برمجة التطبيقات
للحصول على إذن بالوصول إلى واجهات برمجة التطبيقات في "الملف التجاري على Google"، نطلب من جميع مقدّمي الطلبات ما يلي:
- إدارة ملف تجاري تم التحقّق منه ونشط لمدة 60 يومًا أو أكثر يمكن أن يكون هذا الملف التجاري على Google هو مكتب مقدّم الطلب أو مقره الرئيسي، أو يمكن أن يكون تابعًا لأحد العملاء الذين يديرهم.
- أن يكون لديك موقع إلكتروني يمثّل النشاط التجاري المُدرَج في "الملف التجاري على Google"
لضمان مراجعة طلبك بسلاسة وفي الوقت المناسب، ننصحك بإكمال ملفك التجاري على Google بالكامل وإبقائه محدّثًا بأحدث معلومات النشاط التجاري، بما في ذلك الموقع الإلكتروني الرسمي للنشاط التجاري.
بعد استيفاء المتطلبات المذكورة سابقًا، يمكنك طلب الوصول إلى واجهة برمجة التطبيقات باتّباع الخطوات التالية:
- انتقِل إلى Google Cloud Console واختَر المشروع الذي تخطّط لاستخدامه مع واجهات برمجة التطبيقات الخاصة بـ "الملف التجاري على Google".
- ابحث عن رقم مشروعك في بطاقة معلومات المشروع على لوحة بيانات مشروعك. عليك تقديم هذا الرقم في طلبك.
- عندما تكون مستعدًا، أرسِل طلبك باستخدام نموذج التواصل بشأن واجهة برمجة التطبيقات في "نشاطي التجاري على Google". اختَر "طلب الحصول على إذن الوصول الأساسي إلى واجهة برمجة التطبيقات" من القائمة المنسدلة وقدِّم جميع المعلومات المطلوبة.
- تأكَّد من استخدام عنوان بريد إلكتروني مُدرَج كمالك أو مدير في ملفك التجاري على Google.
- سيتم إرسال رسالة إلكترونية إليك بعد مراجعة طلبك.
ملاحظة حول التحقّق من حالة الموافقة: يمكنك أيضًا التحقّق مما إذا تمت الموافقة على مشروعك من خلال الاطّلاع على حصص واجهات برمجة التطبيقات الخاصة بـ "الملف التجاري على Google" في Google Cloud Console.
- إذا كانت حصتك 0 طلب بحث في الدقيقة، يعني ذلك أنّه لم تتم الموافقة على مشروعك بعد.
- إذا تم ضبط الحصة على 300 طلب في الدقيقة، تتم الموافقة على مشروعك.
في حال الموافقة على طلبك، اطّلِع على الإعداد الأساسي لتفعيل واجهات برمجة التطبيقات الخاصة بـ "الملف التجاري على Google" لمشروعك. إذا تم رفض طلبك، تأكَّد من استيفاء المتطلبات المذكورة سابقًا قبل إعادة تقديم الطلب.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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."]]
