تجربة واجهة REST

نقطة أساسية: ننصحك بشدة باستخدام مكتبات البرامج الرسمية للعملاء حيثما أمكن ذلك. يتم تنفيذ جميع مكتبات البرامج التي توفّرها Google باستخدام gRPC، باستثناء مكتبة Perl التي تستخدم واجهة REST. ما لم تكن تبحث تحديدًا عن تفاصيل حول REST، يمكنك الرجوع إلى مستندات gRPC للحصول على مستندات مرجعية تتضمّن مكتبات العملاء الرسمية.

ملاحظة: إذا كنت مبتدئًا في استخدام Google Ads API، ننصحك بقراءة دليل البدء أولاً، والذي يوضّح كيفية إعداد حسابك وإجراء طلب بيانات من واجهة برمجة التطبيقات الأول. احرص على اتّباع علامة التبويب curl.

ننصح باستخدام مكتبات برامج Google الرسمية كلما أمكن ذلك لتطوير التطبيقات، ولكن يمكن أن تكون واجهة REST مفيدة في الحالات التي تريد فيها فقط إرسال طلب لمرة واحدة إلى Google Ads API، مثلاً عندما تريد اختبار سلوك نقطة نهاية أو تصحيح أخطاء طلب معيّن.

في هذه الحالات، توفّر الصفحات المرجعية لنقاط نهاية REST زرّ تجربة يمكنك استخدامه لإرسال طلب واحد إلى Google Ads API للتحقّق من سلوكه.

لاستخدامها، تحتاج إلى الرمز المميّز للمطوّر ورقم تعريف العميل للحساب الذي تريد إرسال الطلب إليه. يجب أيضًا الوصول إلى هذا الحساب لأنّه عليك المصادقة باستخدام حساب Google من خلال OAuth.

بعد الحصول على هذه المعلومات، يمكنك الانتقال إلى صفحة مرجعية خاصة بـ REST، مثل الصفحة الخاصة بنقطة النهاية customers.googleAds/search، والنقر على الزر جرِّب على اليسار لإرسال طلبك.