درحالیکه Mutate، Search، و SearchStream رایجترین روشها
در Google Ads API هستند، روشهای بسیار دیگری برای اهداف خاص وجود دارد. همه سرویسها و
میاناهای برنامهسازی کاربردی آنها در
اسناد مرجع مستندسازی شدهاند.
میانگیری پروتکل RPC به نگاشتهای REST
همه نقطههای پایانی سرویس (چه از REST و چه از gRPC استفاده کنند) درنهایت در فایلهای.proto بسته سرویسها بااستفاده از زبان تعریف واسط proto3 تعریف میشوند.
مثال: ListAccessibleCustomers
برای مثال، فایل customer_service.proto
علاوهبر Mutate استاندارد، روش ListAccessibleCustomers را نیز تعریف میکند
. حاشیهنویسی google.api.http آن توضیح میدهد
که این روش چگونه به HTTP نگاشت میشود. از HTTP GET با فعل سفارشی
listAccessibleCustomers استفاده میکند:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v26/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: "/v26/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
این به روش customers.createCustomerClient REST نگاشت میشود.