طرق أخرى

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

عمليات الربط بين استدعاء الإجراء عن بُعد لمخزن البروتوكولات المؤقت و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: "/v20/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: "/v20/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

يتوافق ذلك مع طريقة REST‏ customers.createCustomerClient.