تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
على الرغم من أنّنا ننصح باستخدام مكتبات البرامج الرسمية الخاصة بالعملاء من Google حيثما أمكن ذلك لتطوير التطبيقات، يمكن أن تكون واجهة REST مفيدة في الحالات التي تريد فيها إصدار طلب لمرة واحدة إلى Google Ads API، مثلاً عندما تريد اختبار سلوك نقطة نهاية أو تصحيح خطأ في طلب.
في هذه الحالات، توفّر الصفحات المرجعية لنقاط نهاية REST زر جرِّبها الذي يمكنك استخدامه لإرسال طلب واحد إلى Google Ads API للتحقّق من سلوكه.
لاستخدامها، عليك توفير الرمز المميز للمطوّر ورقم تعريف العميل للحساب الذي تريد إرسال الطلب إليه. يجب أيضًا أن يكون لديك إذن بالوصول إلى هذا الحساب، لأنّه عليك المصادقة باستخدام حساب Google من خلال OAuth.
بعد الحصول على هذه المعلومات، يمكنك الانتقال إلى صفحة مرجعية خاصة بـ REST، مثل الصفحة الخاصة بنقطة النهاية
customers.googleAds/search
، والنقر على الزر جرِّب على اليسار لإرسال طلبك.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle strongly recommends using their official client libraries for Google Ads API interaction, which are primarily based on gRPC.\u003c/p\u003e\n"],["\u003cp\u003eFor one-time requests or debugging, the REST interface is available with a "Try it!" feature on reference pages for testing.\u003c/p\u003e\n"],["\u003cp\u003eUsing the "Try it!" functionality requires a developer token, customer ID, and Google account authentication via OAuth.\u003c/p\u003e\n"]]],[],null,["# Try out the REST interface\n\n| **Key Point:** We strongly recommend using our [official client\n| libraries](/google-ads/api/docs/client-libs) wherever you can. All Google provided client libraries are implemented using gRPC, except for the [Perl\n| library](https://github.com/googleads/google-ads-perl/) which uses the REST interface. Unless you are specifically looking for details about REST, consult the [gRPC\n| documentation](/google-ads/api/reference/rpc) for reference documentation that covers our official client libraries.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhile we recommend using Google's official [client\nlibraries](/google-ads/api/docs/client-libs) wherever possible for application development,\nthe REST interface can be useful in cases where you just want to issue a\none-time request to the Google Ads API, for instance when you want to test the\nbehavior of an endpoint or to debug a request.\n\nFor these situations, the reference pages for REST endpoints provide a\n**Try it!** button which you can use to send a single request to the Google Ads API\nto verify its behavior.\n\nTo use it, you need your **developer token** and the **customer ID** for the\naccount you want to issue the request against. Access to that account is also\nrequired since you have to authenticate with a Google account using OAuth.\n\nOnce you have these, you can visit a REST reference page, like the one for the\n[`customers.googleAds/search`](/google-ads/api/rest/reference/rest/v21/customers.googleAds/search)\nendpoint, and click the **Try it!** button on the right to send your request."]]
