تنزيل الأدوات ومكتبات البرامج
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
نزِّل الأدوات التالية لإكمال الخطوات المتبقية من هذا البرنامج التعليمي.
واجهة سطر الأوامر (CLI) في Google Cloud
تستخدم Google Ads API بروتوكول OAuth 2.0 كآلية تفويض. يستخدم هذا البرنامج التعليمي
واجهة سطر الأوامر (CLI) في Google Cloud كطريقة لتنفيذ خطوات تفويض مختلفة في OAuth 2.0. اتّبِع التعليمات
لتثبيت gcloud CLI.
تم التأكّد من أنّ التعليمات الواردة في بقية هذا الدليل تعمل مع الإصدار التالي من أداة gcloud، وقد لا تعمل مع الإصدارات السابقة بسبب الاختلافات في سلوك التطبيق أو خيارات سطر الأوامر.
:~$ gcloud version
Google Cloud SDK 492.0.0
alpha 2024.09.06
beta 2024.09.06
bq 2.1.8
bundled-python3-unix 3.11.9
core 2024.09.06
enterprise-certificate-proxy 0.3.2
gcloud-crc32c 1.0.0
gsutil 5.30
مكتبة العميل أو عميل HTTP
يمكنك اختيار تنزيل مكتبة برامج أو برنامج HTTP، وذلك حسب الطريقة التي تريد بها إجراء طلبات البيانات من واجهة برمجة التطبيقات.
استخدام مكتبة برامج
نزِّل مكتبة برامج من اختيارك وثبِّتها.
استخدام عميل HTTP (REST)
نزِّل curl وثبِّته، وهو أداة سطر الأوامر لنقل البيانات من خلال عنوان URL.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide requires downloading and installing \u003ccode\u003eoauth2l\u003c/code\u003e or \u003ccode\u003egcloud CLI\u003c/code\u003e for authorization using OAuth 2.0 to obtain access and refresh tokens.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your \u003ccode\u003eoauth2l\u003c/code\u003e version is v1.3.0 and \u003ccode\u003egcloud CLI\u003c/code\u003e version is 492.0.0 for compatibility with the instructions.\u003c/p\u003e\n"],["\u003cp\u003eYou will need to utilize either a Google Ads API client library or an HTTP client like \u003ccode\u003ecurl\u003c/code\u003e to interact with the API.\u003c/p\u003e\n"]]],[],null,["# Download tools and client libraries\n\nDownload the following tools to complete the remaining steps of this\ntutorial.\n\nThe Google Cloud CLI\n--------------------\n\nThe Google Ads API uses OAuth 2.0 as the authorization mechanism. This tutorial\nuses the Google Cloud CLI as a way to perform various OAuth 2.0 authorization\nsteps. Follow the [instructions](https://cloud.google.com/sdk/docs/install)\nto install gcloud CLI.\n\nThe instructions for the rest of this guide were verified to work with the\nfollowing version of the gcloud tool and might not work with previous versions\ndue to differences in application behavior or command-line options. \n\n :~$ gcloud version\n Google Cloud SDK 492.0.0\n alpha 2024.09.06\n beta 2024.09.06\n bq 2.1.8\n bundled-python3-unix 3.11.9\n core 2024.09.06\n enterprise-certificate-proxy 0.3.2\n gcloud-crc32c 1.0.0\n gsutil 5.30\n\nClient library or HTTP client\n-----------------------------\n\nYou can choose to either download a client library or an HTTP client depending\non how you'd like to make API calls. \n\n### Use a client library\n\nDownload and install a [client library](/google-ads/api/docs/client-libs) of your choice.\n\n### Use HTTP client (REST)\n\nDownload and install [curl](https://curl.se/download.html),\nthe command line tool for transferring data through a URL."]]