على الرغم من أنّ 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: "/v17/customers:listAccessibleCustomers" }; }
يرتبط هذا بطريقة customers.listAccessibleCustomers REST.
مثال: CreateCustomerClient
هناك مثال آخر من customer_service.proto
وهو طريقة CreateCustomerClient
. يصف تعليق google.api.http
التوضيحي له
HTTP POST
باستخدام الفعل المخصّص createCustomerClient
:
rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { option (google.api.http) = { post: "/v17/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
يرتبط هذا بطريقة RST لـ customers.createCustomerClient.