طرق أخرى

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

استدعاء إجراء عن بُعد (RPC) للمخزن المؤقت للبروتوكولات في تعيينات REST

يتم تحديد جميع نقاط نهاية الخدمة (سواءً كنت تستخدم 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: "/v16/customers:listAccessibleCustomers"
  };
}
customer_service.proto

يرتبط هذا بطريقة customers.listAccessibleCustomers REST.

مثال: CreateCustomerClient

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

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

يرتبط هذا بطريقة RST لـ customers.createCustomerClient.