احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به مقدمه REST مراجعه کنید.
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
در حالی که Mutate ، Search ، و SearchStream رایجترین روشها در Google Ads API هستند، روشهای بسیار دیگری برای اهداف خاص وجود دارد. همه سرویس ها و API های آنها در مستندات مرجع REST مستند شده است.
به عنوان مثال، فایل customer_service.proto علاوه بر Mutate استاندارد، یک متد ListAccessibleCustomers را تعریف می کند. حاشیه نویسی google.api.http آن توضیح می دهد که چگونه روش به HTTP نگاشت می شود. از HTTP GET با فعل سفارشی listAccessibleCustomers استفاده می کند:
مثال دیگری از customer_service.proto متد CreateCustomerClient است. حاشیه نویسی google.api.http آن یک HTTP POST با استفاده از فعل سفارشی createCustomerClient توصیف می کند:
تاریخ آخرین بهروزرسانی 2025-03-15 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2025-03-15 بهوقت ساعت هماهنگ جهانی."],[[["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"]]