rocket
نقدّم لك
Merchant API
التي تحلّ رسميًا محلّ Content API في Shopping.
updateالاطّلاع على آخر الأخبار
بشأن الميزات الجديدة وإصلاحات الأخطاء وتحديثات الإصدارات من Merchant API
point_of_sale
تعرَّف على كيفية إدارة نشاطك التجاري ومنتجاتك على Google وكيفية الحصول على إذن وصول آلي إلى البيانات والإحصاءات والميزات الفريدة على نطاق واسع.
ابدأ استخدام Merchant API اليوم.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملخّص
يجب طلب رمز مميز للمطوِّر والحصول على بيانات اعتماد المصادقة لاستخدام Google Ads API وإجراء طلبات بيانات من واجهة برمجة التطبيقات على حساب "إعلانات Google". يمكنك الاطّلاع على دليل البدء السريع لمزيد من التفاصيل.
الخطوات اليدوية
لاستخدام Google Ads API، أكمِل الخطوات التالية:
الحصول على رمز مميز للمطوِّر
يربط الرمز المميز للمطوّر في "إعلانات Google" تطبيقك بواجهة Google Ads API.
يمكنك استرداد الرمز المميّز للمطوّر الخاص بحسابك الإداري في أي وقت من واجهة مستخدم "إعلانات Google"، وذلك ضمن الأدوات والإعدادات > الإعداد > مركز واجهة برمجة التطبيقات.
يمكنك استخدام رمز المطوّر المميز على الفور مع حساب إداري تجريبي. يجب الموافقة على رمز المطوّر قبل أن تتمكّن من استخدامه مع حسابات "إعلانات Google" النشطة.
توفّر واجهة برمجة التطبيقات مستويات الوصول التالية:
لا يُشترط توفّر حسابات اختبارية، ولكنّها تتيح لك إجراء طلبات بيانات من واجهة برمجة التطبيقات واختبار الرمز قبل الموافقة على الرمز المميز للمطوّر. اتّبِع هذه التعليمات لإنشاء حسابات تجريبية وحملات اختبارية.
اختيار مكتبة برامج للعميل
نزِّل إحدى مكتبات برامج واجهة برمجة التطبيقات مع "إعلانات Google".
يتم تضمين عيّنات من الرموز البرمجية وتعليمات التثبيت مع كل مكتبة عملاء.
وسِّع القائمة المنسدلة المشاريع، ثم اختَر مشروع جديد.
أدخِل اسمًا للمشروع، ثم انقر على إنشاء.
في الشريط الجانبي، انقر على شاشة موافقة OAuth، ثم أدخِل المعلومات المطلوبة، وانقر على حفظ ومتابعة. لمزيد من التفاصيل، يُرجى الاطّلاع على دليل OAuth.
في الشريط الجانبي، انقر على بيانات الاعتماد > إنشاء بيانات اعتماد > معرّف عميل OAuth، ثم اختَر تطبيق على الكمبيوتر.
أدخِل اسمًا لعميلك، ثم انقر على إنشاء.
سيؤدي ذلك إلى إنشاء معرّف العميل وسر العميل.
الحصول على رمز مميز لإعادة التحميل
تحتاج أيضًا إلى رمز مميّز لإعادة التحميل من أجل الوصول إلى واجهات Google API.
للحصول على رمز مميّز لإعادة التحميل، اتّبِع الخطوات الخاصة بمكتبة البرامج التي اخترتها. تختلف الخطوات حسب لغة البرمجة. اطّلِع على نماذج المصادقة لكل مكتبة.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eTo use the Google Ads API, you must obtain a developer token and set up authentication credentials.\u003c/p\u003e\n"],["\u003cp\u003eDeveloper tokens have different access levels (Test, Basic, Standard) and require approval for production use.\u003c/p\u003e\n"],["\u003cp\u003eSetting up OAuth2 involves creating a Google API Console project and generating a client ID and secret.\u003c/p\u003e\n"],["\u003cp\u003eYou need a refresh token, obtained through steps specific to your chosen client library, for Google API access.\u003c/p\u003e\n"],["\u003cp\u003eTest accounts are recommended for initial code testing before your developer token is approved for live accounts.\u003c/p\u003e\n"]]],[],null,["# Set up Google Ads API access\n\nSummary\n-------\n\nYou must request a [developer token](/google-ads/api/docs/first-call/dev-token) and obtain authentication credentials to\nuse the [Google Ads API](/google-ads/api/docs/start) and make API calls on a Google Ads account. See the\n[Quickstart guide](/google-ads/api/docs/first-call/overview) for more detail.\n\nManual steps\n------------\n\nTo use the Google Ads API, complete the following steps:\n\n### Obtain a developer token\n\nA Google Ads developer token connects your app to the Google Ads API.\n\n1. Follow the steps in [Obtain Your Developer Token](/google-ads/api/docs/first-call/dev-token).\n2. After signing up, your token is **pending approval**.\n3. Make sure your software adheres to the Google Ads API [Terms and Conditions\n (T\\&C)](/google-ads/api/terms) and the [Required Minimum Functionality (RMF)](/google-ads/api/docs/rmf). RMF is only required for tokens with Standard Access.\n\nYou can retrieve the developer token for your manager account at any time in the\n[Google Ads UI](https://ads.google.com), under **TOOLS \\& SETTINGS \\\u003e SETUP \\\u003e API Center**.\n\nYou can use your developer token immediately with a test manager account. Your\ndeveloper token must be approved before you can use it with production Google\nAds accounts.\n\nThe API provides the following access levels:\n\n- Test\n- Basic\n- Standard\n\nSee [Access Levels \\& Permissible Use](/google-ads/api/docs/access-levels) for more information on each level.\n\n### Create test accounts\n\nTest accounts aren't required, but they let you make API calls and test your\ncode before your developer token is approved. Follow [these\ninstructions](/google-ads/api/docs/first-call/test-accounts#create) to\ncreate test accounts and test campaigns.\n\n### Choose a client library\n\nDownload one of the Google Ads API [client libraries](/google-ads/api/docs/client-libs).\n\nCode samples and installation instructions are included with each client\nlibrary.\n\n### Set up OAuth2\n\n[OAuth2](https://oauth.net/2/) lets your app operate on behalf of your account. This workflow is for\ndesktop apps, see [Configure a Google API Console Project](/google-ads/api/docs/first-call/oauth-cloud-project) for more\ninformation.\n\nTo use OAuth2 with Google APIs, create an OAuth2 client ID and client secret:\n\n1. While signed in to your manager account, open the [Google API Console\n Credentials page](https://console.developers.google.com/apis/credentials).\n2. Expand the **Projects** drop-down, then choose **NEW PROJECT**.\n3. Enter a name for the project, then click **CREATE**.\n4. In the sidebar, click **OAuth consent screen** , then enter the required information, and click **SAVE AND CONTINUE** . See the [OAuth guide](/google-ads/api/docs/first-call/oauth-cloud-project) for more details.\n5. In the sidebar, click **Credenials \\\u003e CREATE CREDENTIALS \\\u003e OAuth client\n ID** , then choose **Desktop app**.\n6. Enter a name for your client, then click **CREATE**.\n\nThis generates your client ID and client secret.\n| **Important:** Save these credentials. You need to add them to the configuration file in your Google Ads API library to use the API.\n\n### Get a refresh token\n\nYou also need a refresh token to access Google APIs.\n\nTo get a [refresh token](/google-ads/api/docs/first-call/refresh-token), follow the steps for your\nchosen [client library](/google-ads/api/docs/client-libs). The steps are different for each\nprogramming language. See the authentication samples for each library.\n\n### Make your first API call\n\nFollow the Google Ads API [First call tutorial](/google-ads/api/docs/first-call/get-campaigns) to make a simple call.\n\nAutomatic steps\n---------------\n\nNot available for this process."]]
