طرق أخرى

في حين أنّ 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.