שיטות אחרות

אמנם Mutate, Search ו-SearchStream הן השיטות הנפוצות ביותר ב-Google Ads API יש הרבה שימושים אחרים למטרות ספציפיות. כל השירותים וגם ממשקי ה-API שלהם מתועדים מסמכי עזר של REST.

מיפויים של RPC למאגר נתונים זמני של פרוטוקול ל-REST

כל נקודות הקצה של השירות (באמצעות REST ו-gRPC) מוגדרות בסופו של דבר ב קובצי.proto של חבילת השירותים באמצעות proto3 Interface Definition Language.

דוגמה: ListAccessibleCustomers

לדוגמה, הקובץ customer_service.proto מגדיר שיטת ListAccessibleCustomers, בנוסף ל-Mutate הסטנדרטי הקצר הזה. התשובות שלך יעזרו לנו להשתפר. ההערה google.api.http מתארת האופן שבו ה-method ממופה ל-HTTP. היא משתמשת ב-HTTP GET עם פועל מותאם אישית listAccessibleCustomers:

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v17/customers:listAccessibleCustomers"
  };
}
customer_service.proto

פריט זה ממופה אל 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";
}
customer_service.proto

פעולה זו ממופה אל customers.createCustomerClient שיטת REST.