แม้ว่า Mutate
, Search
และ SearchStream
จะเป็นเมธอดที่ใช้กันมากที่สุด
ใน Google Ads API ยังมีฟังก์ชันอื่นๆ อีกมากมายสำหรับวัตถุประสงค์ที่เฉพาะเจาะจง บริการทั้งหมดและ
มีการบันทึก API ไว้ใน
เอกสารอ้างอิง REST
การแมปบัฟเฟอร์โปรโตคอล RPC กับ REST
ระบบจะกำหนดปลายทางบริการทั้งหมด (ไม่ว่าจะใช้ REST และ gRPC) ในท้ายที่สุด ในช่วง ไฟล์.proto ของแพ็กเกจบริการ โดยใช้ pro3 Interface Definition Language
ตัวอย่าง: ListAccessibleCustomers
เช่น ไฟล์ customer_service.proto
กำหนดเมธอด ListAccessibleCustomers
นอกเหนือจาก Mutate
มาตรฐาน
ที่ใช้เวลาเพียง 2 นาที คำอธิบายประกอบ 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