طرق أخرى

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

في حين أنّ Mutate وSearch وSearchStream هي الطرق الأكثر شيوعًا في Google Ads API، هناك العديد من الطرق الأخرى لأغراض محدّدة. تم توثيق جميع الخدمات و واجهات برمجة التطبيقات الخاصة بها في المستندات المرجعية.

عمليات الربط بين استدعاء الإجراء عن بُعد لـ Protocol Buffers وREST

يتم تحديد جميع نقاط نهاية الخدمة (سواء باستخدام REST وgRPC) في نهاية المطاف في ملفات ‎.proto لحزمة الخدمات باستخدام لغة تعريف الواجهة proto3.

مثال: ListAccessibleCustomers

على سبيل المثال، يحدّد ملف customer_service.proto طريقة ListAccessibleCustomers، بالإضافة إلى طريقة Mutate العادية. تصف تعليقة google.api.http كيفية ربط الطريقة ببروتوكول HTTP. تستخدِم هذه الطريقة طلب HTTP GET مع الفعل المخصّص listAccessibleCustomers:

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v26/customers:listAccessibleCustomers"
  };
}

يرتبط هذا الإجراء بطريقة REST‏ customers.listAccessibleCustomers.

مثال: CreateCustomerClient

مثال آخر من customer_service.proto هو الطريقة CreateCustomerClient. تصف تعليقة google.api.http طلب HTTP POST باستخدام الفعل المخصّص createCustomerClient:

rpc CreateCustomerClient(CreateCustomerClientRequest)
    returns (CreateCustomerClientResponse) {
  option (google.api.http) = {
    post: "/v26/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

يرتبط هذا الإجراء بطريقة REST‏ customers.createCustomerClient.