تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن طلب Google Ads API باستخدام gRPC أو REST. تعرض كلتا الواجهتين تصميمًا موجّهًا إلى الموارد تتم مشاركته مع واجهات برمجة تطبيقات Google Cloud الأخرى.
ننصحك باستخدام مكتبات العملاء الرسمية من Google كلما أمكن ذلك. وهي توفر رمزًا اصطلاحيًا آمنًا في الكتابة بكل لغة متوافقة، كما أنها تتعامل مع العديد من تفاصيل الاتصال بواجهة برمجة التطبيقات (مثل إعدادات المهلة وتقسيم النتائج على عدّة صفحات والمصادقة). وتتضمّن مكتبات العملاء لدينا أيضًا مجموعة واسعة من أمثلة الرموز والأدوات المساعدة التي تساعد في المهام الشائعة، مثل إنشاء أسماء الموارد والتعامل مع أقنعة الحقول.
يقدم هذا الدليل تفاصيل خاصة بـ REST ويشرح ما تحتاج إلى معرفته
لاستدعاء واجهة REST مباشرةً، بدون استخدام مكتبة برامج متوافقة مع Google. قد يكون هذا الدليل مفيدًا إذا كنت تكتب رمزك المخصّص لاستخدام REST مباشرةً أو إذا كنت تستخدم مكتبة برامج HTTP تابعة لجهة خارجية.
تاريخ التعديل الأخير: 2025-03-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-03-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Google Ads API can be accessed using either gRPC or REST, with gRPC being the recommended method for interacting with the API."],["Official Google client libraries, built on gRPC (except for Perl which uses REST), are strongly encouraged for ease of use and handling low-level communication details."],["This guide focuses on using the REST interface directly, primarily for users building custom solutions or using third-party HTTP client libraries."],["Client libraries provide benefits like idiomatic code, type safety, pagination handling, authentication, and access to code examples and utilities for common tasks."]]],["The Google Ads API utilizes gRPC or REST interfaces, sharing a resource-oriented design. Using Google's client libraries is highly recommended for type-safe code, handling communication details like timeouts, pagination, and authentication. The official client libraries use gRPC, except for the Perl library, which uses REST. This guide details using REST directly without client libraries, useful for custom code or third-party HTTP clients. It focuses on information outside of what the official client libraries cover.\n"]]
