تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على
مقدمة عن REST للحصول على التفاصيل.
طرق أخرى
على الرغم من أنّ Mutate وSearch وSearchStream هي الطرق الأكثر شيوعًا
في Google Ads API، هناك العديد من الطرق الأخرى لأغراض محدّدة. تم توثيق جميع الخدمات و
واجهات برمجة التطبيقات الخاصة بها في
مستندات مرجعية حول واجهة برمجة التطبيقات REST.
عمليات الربط بين بروتوكول استدعاء الإجراء عن بُعد (RPC) وواجهة برمجة التطبيقات (REST) في "مخزن البروتوكولات المؤقت"
يتم تحديد جميع نقاط نهاية الخدمة (سواء باستخدام REST وgRPC) في نهاية المطاف
في
ملفات proto.لحزمة الخدمات
باستخدام
لغة تعريف واجهة proto3.
مثال: ListAccessibleCustomers
على سبيل المثال، يحدِّد ملف customer_service.proto
طريقة ListAccessibleCustomers، بالإضافة إلى Mutate
العادي. يصف التعليق التوضيحي google.api.http
كيفية ربط الطريقة ببروتوكول HTTP. ويستخدم GET HTTP مع الفعل المخصّص
listAccessibleCustomers:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
returns (ListAccessibleCustomersResponse) {
option (google.api.http) = {
get: "/v19/customers:listAccessibleCustomers"
};
}
وتتطابق هذه الطريقة مع أسلوب برمجة التطبيقات REST في
customers.listAccessibleCustomers.
مثال: CreateCustomerClient
مثال آخر من customer_service.proto هو
طريقة CreateCustomerClient. يصف التعليق التوضيحي google.api.http POST HTTP باستخدام الفعل المخصّص createCustomerClient:
rpc CreateCustomerClient(CreateCustomerClientRequest)
returns (CreateCustomerClientResponse) {
option (google.api.http) = {
post: "/v19/customers/{customer_id=*}:createCustomerClient"
body: "*"
};
option (google.api.method_signature) = "customer_id,customer_client";
}
يتمّ ربط هذا الإجراء بطريقة customers.createCustomerClient
REST.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["While `Mutate`, `Search`, and `SearchStream` are commonly used, the Google Ads API offers a wide range of methods for specific tasks, all documented in the REST reference documentation."],["All Google Ads API service endpoints, including REST and gRPC, are defined in .proto files using the proto3 Interface Definition Language."],["The `google.api.http` annotation within these .proto files details how each method maps to HTTP for RESTful interactions, including examples like `ListAccessibleCustomers` and `CreateCustomerClient`."]]],["The Google Ads API includes various methods beyond `Mutate`, `Search`, and `SearchStream`, all detailed in REST documentation. Service endpoints are defined in `.proto` files using proto3. `ListAccessibleCustomers` is a GET method, mapped using the `google.api.http` annotation in the `customer_service.proto` file, and uses custom verb `listAccessibleCustomers`. Similarly, `CreateCustomerClient`, a POST method, uses custom verb `createCustomerClient`, also defined in the same file.\n"]]
