سایر روش ها

در حالی که Mutate ، Search ، و SearchStream رایج‌ترین روش‌ها در Google Ads API هستند، روش‌های بسیار دیگری برای اهداف خاص وجود دارد. همه سرویس ها و API های آنها در مستندات مرجع REST مستند شده است.

پروتکل بافر 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: "/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 نگاشت می شود.