API های پیشرفته در اسکریپت های Google Ads به توسعه دهندگان باتجربه این امکان را می دهند که با تنظیمات کمتری نسبت به استفاده از رابط های HTTP خود، به برخی از API های عمومی Google متصل شوند. شما از این API ها مانند سرویس های داخلی اسکریپت ها استفاده می کنید، و آنها همان امکاناتی مانند تکمیل خودکار و مجوز خودکار را ارائه می دهند.
کاربردهای احتمالی APIهای پیشرفته
- گوگل آنالیتیکس
- می‌توانید از Google Analytics برای ردیابی ترافیک ورودی به وب‌سایت خود استفاده کنید و قیمت‌های کمپین خود را بر اساس آن تنظیم کنید. اگر یک ویژگی Google Analytics را به حساب Google Ads خود پیوند دهید، می توانید فعالیت مشتری در وب سایت خود را نیز تجزیه و تحلیل کنید. این اطلاعات می تواند نشان دهد که چه مقدار از ترافیک یا فروش وب سایت شما از تبلیغات Google است و به شما در بهبود تبلیغات و وب سایت کمک می کند. می‌توانید درباره پیوند دادن حساب‌های Analytics و Google Ads در مرکز راهنمایی ما اطلاعات بیشتری کسب کنید.
- Google BigQuery
- می‌توانید مقادیر زیادی داده را در Google Cloud Storage بارگیری کنید و سپس با استفاده از Google BigQuery آن داده‌ها را پرس و جو کنید. برای مثال، می‌توانید داده‌های عمومی آب و هوا را برای 10 سال گذشته بارگیری کنید و سپس میانگین دمای یک منطقه را در اسکریپتی که از آن اطلاعات در تنظیم قیمت‌ها استفاده می‌کند، پرس و جو کنید. یکی دیگر از موارد استفاده این است که داده های عملکرد حساب خود را طی چندین سال بررسی کنید.
- YouTube و YouTube Analytics
- می‌توانید ویدیوها، فهرست‌های پخش و غیره و همچنین داده‌های عملکرد ویدیوهای خود را بازیابی و به‌روزرسانی کنید تا تصمیم‌گیری در مورد مناقصه بگیرید.
- تقویم گوگل
- اسکریپت شما می‌تواند رویدادهایی را برای کارهای آینده ایجاد کند (برای مثال، یک گزارش عملکرد برای کمپین‌های خود را ۲ هفته از امروز اجرا کنید)، یا اقداماتی را بر اساس ورودی‌هایی که در تقویم خود ایجاد کرده‌اید انجام دهد (به عنوان مثال، یک کمپین را در یک تاریخ خاص فعال کنید).
- محتوای خرید
- اسکریپت شما می‌تواند از Google Content API برای خرید در Apps Script استفاده کند. این API به کاربران Google Merchant Center امکان آپلود و مدیریت لیست محصولات خود و مدیریت حساب های Merchant Center خود را می دهد. در اسکریپت ها، این می تواند برای بررسی لیست محصولات و پیوند دادن محصولات خاص به تبلیغات خاص مفید باشد.
- Google Tasks
- اسکریپت شما می‌تواند یک لیست یادآوری برای کارهای آینده ایجاد کند (به عنوان مثال، یک گزارش عملکرد برای کمپین‌های خود را دو هفته از امروز اجرا کنید)، یا اقداماتی را بر اساس ورودی‌هایی که در فهرست یادآوری ایجاد کرده‌اید انجام دهد (برای مثال، یک کمپین را در یک کمپین خاص فعال کنید. تاریخ).
- اسلایدهای گوگل
- اسکریپت شما می‌تواند جزئیات یا آمار کمپین را به Google Slides صادر کند تا چنین اطلاعاتی را در قالبی قابل ارائه منتشر کند.
API های پیشرفته را فعال کنید
برای مشاهده اینکه کدام APIهای Google به عنوان APIهای پیشرفته در دسترس هستند، روی دکمه Advanced APIs در نوار ویرایشگر بالا کلیک کنید.
با این کار گفتگوی Advanced APIs ظاهر می شود. API هایی را که می خواهید فعال کنید بررسی کنید.
سپس، روی پیوند Google API Console کلیک کنید تا صفحه API Console در کنسول، با پروژه مرتبط با اسکریپت شما نمایش داده شود. یا اگر پروژه شما قبلاً انتخاب نشده است، آن را از لیست کشویی Project انتخاب کنید. با وارد کردن نام API در نوار جستجو، API هایی را که می خواهید در اسکریپت خود استفاده کنید، جستجو کنید.
در نتایج جستجو، API را انتخاب کنید و در صفحه بعد فعال کردن را انتخاب کنید. اگر دکمه Disable را مشاهده کردید، این API قبلاً فعال شده است. این عمل را برای هر API که می خواهید فعال کنید تکرار کنید.
برای مشاهده لیست APIهای فعال شده برای پروژه، صفحه داشبورد را انتخاب کنید. بررسی کنید که همه APIهای پیشرفته ای که می خواهید برای اسکریپت استفاده کنید فهرست شده باشند.
اکنون گفتگوی Advanced APIs را ببندید تا به ویرایشگر خود بازگردید. APIهای جدید برای اسکریپت شما فعال خواهند شد و در لیست تکمیل خودکار موجود خواهند بود.
API های موجود
API های زیر برای استفاده در دسترس هستند:
| نام API | مستندات |
|---|---|
| گوگل آنالیتیکس | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| تقویم گوگل | https://developers.google.com/apps-script/advanced/calendar |
| اسلایدهای گوگل | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| محتوای خرید | https://developers.google.com/apps-script/advanced/shopping-content |
| یوتیوب | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
همچنین می‌توانید برای نمونه‌هایی در مورد نحوه استفاده از این APIها به صفحه کدهای ما مراجعه کنید.
ملاحظات نهایی
هنگام کار با API های پیشرفته باید به چند نکته توجه داشت.
شناسه پروژه
هر اسکریپت Google Ads دارای شناسه پروژه Google Cloud Platform (همچنین به عنوان شماره پروژه شناخته می شود) مرتبط با آن است. با باز کردن صفحه Google API Console از گفتگوی Advanced APIs می توانید شماره پروژه اسکریپت خود را پیدا کنید. این شناسه پروژه هنگام ایجاد اسکریپت ایجاد می شود و به کاربری که اسکریپت Google Ads را ایجاد کرده است گره می خورد. اگر کاربری که اسکریپت را ایجاد کرده بعداً از حساب حذف شود، از کاربری که سعی می‌کند به اسکریپت دسترسی پیدا کند از شما خواسته می‌شود تا دوباره مجوز اسکریپت را صادر کند و وابستگی‌های Advanced API را دوباره تنظیم کند. شناسه پروژه توسعه‌دهنده Google جدید نیز ایجاد می‌شود، و باید APIهای پیشرفته را مجدداً تنظیم کنید، همانطور که قبلاً در این سند توضیح داده شد.
وابستگی ها
فقط کاربری که اسکریپت را در حساب ایجاد کرده است می تواند وابستگی های Advanced APIs را برای آن اسکریپت تغییر دهد.
مجوزها
هنگام دسترسی به APIها، یک اسکریپت از مجوزهای کاربری استفاده می کند که اسکریپت را مجاز کرده است. اطمینان حاصل کنید که کاربری که اسکریپت را مجاز کرده است به همه APIهای پیشرفته مورد استفاده و همچنین داده‌های مورد نیاز اسکریپت دسترسی لازم را دارد. اگر از Google Analytics API استفاده می‌کنید، مطمئن شوید که کاربری که اسکریپت را مجاز کرده است، مجوزهای لازم برای دسترسی به حساب Analytics را دارد.
شرایط و ضوابط
هر یک از APIهای پیشرفته ممکن است شرایط و ضوابط خاص خود را داشته باشد که هنگام فعال کردن API در Google API Console باید آنها را بپذیرید.
سهمیه
اکثر APIهای پیشرفته دارای سهمیه روزانه رایگان مرتبط با آن هستند. هنگامی که اسکریپت شما از این سهمیه فراتر رفت، API تا زمانی که داده‌های اضافی را درخواست نکنید یا سهمیه رایگان دوباره پر شود، کار نمی‌کند. می‌توانید با باز کردن Google API Console برای اسکریپت از گفتگوی Advanced APIs ، سهمیه استفاده شده توسط اسکریپت خود را کنترل کنید . کنسول API Google همچنین راهی برای درخواست سهمیه اضافی برای API در اختیار شما قرار می دهد.
صورتحساب
برخی از APIهای پیشرفته از شما می خواهند برای استفاده هزینه کنید. این پرداخت‌ها از طریق پروژه Google Cloud Platform مرتبط با اسکریپت شما و نه از طریق Google Ads مدیریت می‌شوند. برای جزئیات بیشتر درباره نحوه فعال کردن صورتحساب برای پروژه Google Cloud Platform اسکریپت خود، به مستندات ما مراجعه کنید.