احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به
مقدمه REST مراجعه کنید.
ارسال بازخورد
سایر روش ها
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
در حالی که Mutate
، Search
، و SearchStream
رایجترین روشها در Google Ads API هستند، روشهای بسیار دیگری برای اهداف خاص وجود دارد. همه سرویس ها و API های آنها در مستندات مرجع REST مستند شده است.
پروتکل بافر 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 : "/ 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-09-23 بهوقت ساعت هماهنگ جهانی.
[{
"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\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-09-23 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","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-23 بهوقت ساعت هماهنگ جهانی."]]