تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على
مقدمة عن REST للحصول على التفاصيل.
إرسال ملاحظات
طرق أخرى
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في حين أنّ Mutate
وSearch
وSearchStream
هي أكثر الطرق شيوعًا.
في Google Ads API، وغير ذلك الكثير لأغراض محدّدة. سيتم توفير جميع الخدمات
يتم توثيق واجهات برمجة التطبيقات الخاصة بها في
المستندات المرجعية لـ REST :
تعيينات استدعاء إجراء عن بُعد لمخزن البروتوكول المؤقت إلى تعيينات REST
يتم تحديد جميع نقاط نهاية الخدمة (سواء باستخدام REST وgRPC) بشكل نهائي.
في
ملفات.proto لحزمة الخدمات
باستخدام
لغة تعريف واجهة proto3 .
مثال: ListAccessibleCustomers
على سبيل المثال، ملف customer_service.proto
طريقة ListAccessibleCustomers
، بالإضافة إلى طريقة Mutate
القياسية
. يصف التعليق التوضيحي 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.
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-10 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
هل تريد مشاركة ملاحظاتك معنا؟
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-09-10 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-10 (حسب التوقيت العالمي المتفَّق عليه)"]]