تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على
مقدمة عن REST للحصول على التفاصيل.
إرسال ملاحظات
تصميم واجهة REST
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تفترض هذه الصفحة أن هناك إلمامًا بسياسة الموارد
التصميم والمورد
أدلة المطوّرين الخاصة بالأسماء
تزويدها بتفاصيل محددة في تنفيذ Google Ads API.
نقطة رئيسية: تستخدم الأمثلة في هذا الدليل بروتوكول HTTP لتوضيح أنّ
كيفية طلب واجهة برمجة التطبيقات. يمكنك الاطّلاع على صفحة أمثلة على
كيف يمكنك إجراء طلبات البيانات من واجهة برمجة التطبيقات نفسها باستخدام curl
سطر الأوامر
تصميم موجّه للموارد
بشكل عام، تتبع Google Ads API تصميمًا موجّهًا إلى الموارد، تم تصميمه على النحو التالي:
مجموعات من الموارد التي يمكن توجيهها بشكل فردي (أسماء واجهة برمجة التطبيقات).
وتتم الإشارة إلى الموارد بأسماء مواردها ومعالجتها باستخدام أداة
الطرق (المعروفة أيضًا باسم الأفعال أو العمليات ).
يتم الجمع بين أسماء الموارد والطرق هذه
بادئة إصدار واجهة برمجة التطبيقات ، ستنشئ عناوين URL لواجهة REST.
على سبيل المثال، يمكن تقسيم عنوان URL أدناه إلى هذه المكوّنات الفردية
وفقًا للجدول التالي:
https://googleads.googleapis.com/v17/customers/1234567890:mutate
بادئة إصدار واجهة برمجة التطبيقات
اسم المورد (نسبي)
الطريقة
https://googleads.googleapis.com/v17
customers/1234567890
mutate
جميع عناوين URL REST الخاصة بإصدار معيّن من واجهة برمجة التطبيقات (مثل v17
)
مشاركة بادئة شائعة لإصدار واجهة برمجة التطبيقات. اسم المورد وطريقته معًا
يحدد خدمة واجهة برمجة التطبيقات التي يتم طلبها.
تستخدم Google Ads API الطرق المخصّصة بشكل مكثّف، على عكس معظم
واجهات برمجة تطبيقات REST التقليدية التي تستخدم طرق REST عادية مثل list
وget
create
وupdate
وdelete
أمثلة على الطرق المخصّصة في Google Ads API
تشمل search
وsearchStream
وmutate
.
تتضمّن الصفحات التالية مزيدًا من التفاصيل عن موارد Google Ads API.
والأسماء وطرق الخدمة
اصطلاحات تسمية JSON لتوضيح كيفية استخدامها
معًا لتحديد نقاط نهاية واجهة REST.
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
هل تريد مشاركة ملاحظاتك معنا؟
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-08-22 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)"]]