طرق أخرى

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

عمليات الربط بين بروتوكول استدعاء الإجراء عن بُعد (RPC) وواجهة برمجة التطبيقات (REST) في Protocol Buffers

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

مثال: ListAccessibleCustomers

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

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

يتمّ ربط هذا الإجراء بإجراء واجهة برمجة التطبيقات customers.listAccessibleCustomers.

مثال: CreateCustomerClient

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

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

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