تجربة واجهة 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 ، والنقر على الزر تجربتها على يسار الصفحة لإرسال طلبك.