ابزار جستجو
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
واکشی ارجاع به کلاس‌های پروتو هنگام استفاده از API مستلزم آن است که یا درک ذاتی از API داشته باشید یا نیاز به جستجوی مکرر اسناد مرجع پروتو برای مسیر دقیق داشته باشید.
ProtoLookupUtil
ابزار جستجوی پروتو به شما امکان می‌دهد بدون نیاز به پیگیری شماره‌های نسخه API و فضاهای نام، نمونه‌هایی از خدمات، عملیات، شمارش‌ها و منابع را جستجو کرده و ایجاد کنید.
در اینجا نحوه نمونه سازی یک کمپین به این صورت است:
campaign = Google::Ads::GoogleAds::V21::Resources::Campaign.new
اما با ابزار جستجوی پروتو، می‌توانید از یک فرم ساده‌تر استفاده کنید:
campaign = client.resource.campaign
هنگام واکشی یک منبع، سرویس یا عملیات، نمونه ای از آن موجودیت برگردانده می شود. هنگام واکشی یک شمارش، ارجاع به کلاس، بدون نمونه سازی، برگردانده می شود.
برای شمارش‌ها، می‌توانید از یک میانبر برای دور زدن نیاز به جستجوی پروتوهای شمارش استفاده کنید.
campaign.status = :PAUSED
توصیه می کنیم از روش client.service برای واکشی خدمات استفاده کنید، حتی اگر از این ابزار برای موارد استفاده دیگری استفاده نمی کنید. منطق اضافی در این روش برای ارسال توکن توسعه دهنده و جزئیات احراز هویت وجود دارد که اگر از روش دیگری استفاده می کردید، باید به صورت دستی آن را مدیریت کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe ProtoLookupUtil simplifies interactions with the Google Ads API by removing the need to specify API version numbers and namespaces when working with services, operations, enumerations, and resources.\u003c/p\u003e\n"],["\u003cp\u003eInstead of manually instantiating proto classes with complex paths, the utility allows you to create and access them using a more concise and intuitive syntax, such as \u003ccode\u003eclient.resource.campaign\u003c/code\u003e instead of \u003ccode\u003eGoogle::Ads::GoogleAds::V18::Resources::Campaign.new\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt offers a shortcut for using enumerations directly, like assigning \u003ccode\u003e:PAUSED\u003c/code\u003e to a campaign status, without requiring explicit proto lookups.\u003c/p\u003e\n"],["\u003cp\u003eUsing \u003ccode\u003eclient.service\u003c/code\u003e is recommended for fetching services, as it automatically handles developer token and authentication details.\u003c/p\u003e\n"]]],[],null,["# Lookup Util\n\nFetching references to proto classes when using the API requires that you either\nhave an intrinsic understanding of the API or need to frequently look up the\nproto reference documentation for the exact path.\n\nProtoLookupUtil\n---------------\n\nThe proto lookup util lets you look up and create instances of services,\noperations, enumerations, and resources without having to keep track of API\nversion numbers and namespaces.\n\nHere's how you typically instantiate a campaign: \n\n campaign = Google::Ads::GoogleAds::V21::Resources::Campaign.new\n\nBut with the proto lookup util, you can use a simpler form: \n\n campaign = client.resource.campaign\n\nWhen fetching a resource, service, or operation, an instance of that entity is\nreturned. When fetching an enumeration, a reference to the class is returned,\nwithout instantiation.\n\nFor enumerations, you can use a shortcut to bypass the need for looking up the\nenumeration protos. \n\n campaign.status = :PAUSED\n\nWe recommend using the `client.service` method to fetch services even if you\ndon't use this utility for any other use cases. There is extra logic built into\nthis method to pass along your developer token and authentication details, which\nyou would have to handle manually if you used another method."]]
