روش‌های دیگر

توجه: اگر با Google Ads API آشنایی ندارید، توصیه می‌کنیم ابتدا راهنمای شروع به کار را بخوانید که نحوه راه‌اندازی حساب و برقراری اولین تماس API را پوشش می‌دهد. حتماً برگه curl را دنبال کنید.

درحالی‌که 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"
  };
}

این مورد به روش REST customers.listAccessibleCustomers نگاشت می‌شود.

مثال: 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";
}

این به روش REST customers.createCustomerClient نگاشت می‌شود.