في حين أنّ Mutate
وSearch
وSearchStream
هي أكثر الطرق شيوعًا.
في Google Ads API، وغير ذلك الكثير لأغراض محدّدة. سيتم توفير جميع الخدمات
يتم توثيق واجهات برمجة التطبيقات الخاصة بها في
المستندات المرجعية لـ REST:
تعيينات استدعاء إجراء عن بُعد لمخزن البروتوكول المؤقت إلى تعيينات 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: "/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"; }
وينطبق هذا الأمر على customers.createCustomerClient REST.