الاستعداد لاستخدام واجهة People API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قبل أن تتمكن من البدء في ترميز تطبيق العميل الأول، عليك
القيام بثلاثة أشياء:
- الحصول على حساب Google
- إنشاء مشروع
- إعداد التطبيق
يرشدك هذا الدليل خلال هذه المهام، إذا لم يسبق لك تنفيذها.
1- الحصول على حساب Google
تحتاج إلى حساب Google من أجل
إنشاء مشروع في وحدة تحكم واجهة برمجة تطبيقات Google. إذا كان لديك حساب بالفعل،
فأنت جاهز تمامًا. قد ترغب أيضًا في حساب Google منفصل
لأغراض الاختبار.
2. إنشاء مشروع لعميلك
قبل إرسال طلبات إلى واجهة برمجة التطبيقات للأشخاص، عليك إبلاغ Google
بعميلك وتفعيل الوصول إلى واجهة برمجة التطبيقات. يمكنك إجراء ذلك باستخدام وحدة تحكم واجهة برمجة التطبيقات في Google لإنشاء مشروع، وهو مجموعة مُعينة من الإعدادات ومعلومات الدخول إلى واجهة برمجة التطبيقات، وتسجيل تطبيقك.
لبدء استخدام People API، عليك أولاً استخدام أداة الإعداد التي سترشدك خلال خطوات إنشاء مشروع في وحدة التحكم في واجهة Google API وتفعيل واجهة برمجة التطبيقات وإنشاء بيانات الاعتماد.
3. إعداد التطبيق
إذا كنت تستخدم إحدى اللغات المتاحة، يمكنك استخدام إحدى
مكتبات البرامج. قبل أن تتمكن من إجراء طلبات إلى واجهة برمجة التطبيقات،
يجب عليك إعداد تفويض.
ألقِ نظرة على
نموذج رمز البدء السريع
الذي يوضّح لك كيفية جلب قائمة بجهات الاتصال بلغات مختلفة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eTo begin coding your client application, you must first obtain a Google Account, create a project in the Google API Console, and set up your app.\u003c/p\u003e\n"],["\u003cp\u003eCreating a project involves informing Google about your client and activating API access using the Google API Console, where you can register your application and manage settings.\u003c/p\u003e\n"],["\u003cp\u003eBefore making requests to the API, ensure you've set up authorization and consider utilizing client libraries if your language is supported.\u003c/p\u003e\n"]]],["To start coding, you must first obtain a Google Account. Then, use the Google API Console to create a project, which involves registering your application and enabling API access via the setup tool. Finally, set up your application, potentially using a client library and ensuring proper authorization before making API requests. Sample code is available to demonstrate fetching a list of contacts in various languages.\n"],null,["# Get Ready to Use the People API\n\nBefore you can start coding your first client application, you need to do three\nthings:\n\n1. Get a Google Account\n2. Create a project\n3. Set up your app\n\nThis guide walks you through those tasks, if you haven't done them already.\n\n1. Get a Google Account\n-----------------------\n\nYou need a [Google Account](https://www.google.com/accounts/NewAccount) in order\nto [create a project](#project) in the Google API Console. If you already have\nan account, then you're all set. You may also want a separate Google Account for\ntesting purposes.\n\n2. Create a project for your client\n-----------------------------------\n\nBefore you can send requests to the People API, you need to tell Google\nabout your client and activate access to the API. You do this by using the Google API Console to create a project, which is a named collection of\nsettings and API access information, and register your application.\n\nTo get started using People API, you need to first\n[use\nthe setup tool](https://console.cloud.google.com/start/api?id=people.googleapis.com&credential=client_key), which guides you through creating a project in the\nGoogle API Console, enabling the API, and creating credentials.\n\n3. Set up your app\n------------------\n\nIf you are using one of the supported languages, consider using one of the\n[client libraries](/people/v1/libraries). Before you can make requests to the\nAPI, you must set up [authorization](/people/v1/how-tos/authorizing).\n\nTake a look at the\n[quick start sample code](https://developers.google.com/people/quickstart/js)\nwhich shows you how to fetch a list of contacts in a variety of languages."]]
