میاناهای برنامه‌سازی کاربردی پیشرفته در جاوااسکریپت Google Ads به توسعه‌دهندگان اجازه می‌دهد با راه‌اندازی کمتری نسبت به استفاده از میاناهای HTTP به میاناهای برنامه‌سازی کاربردی عمومی Google متصل شوند. می‌توانید از این میاناهای برنامه‌سازی کاربردی مانند سرویس‌های داخلی اسکریپت‌ها استفاده کنید و آن‌ها همان راحتی‌ها را مانند تکمیل خودکار و مجوزدهی خودکار ارائه می‌دهند.
برای دیدن چند نمونه که نحوه استفاده از این میاناهای برنامه‌سازی کاربردی را نشان می‌دهد، به صفحه تکه‌کدهای ما مراجعه کنید.
میاناهای برنامه‌سازی کاربردی پیشرفته دردسترس
- Google Analytics
- توجه: میانای برنامه‌سازی کاربردی پیشرفته
Analyticsدر کادر گفتگوی میاناهای برنامه‌سازی کاربردی پیشرفته، میانای برنامه‌سازی کاربردی Universal Analytics v3 را که تعطیل شده است هدف قرار می‌دهد و درخواست‌های ارسال‌شده به آن ناموفق است. جاوااسکریپت Google Ads از سرویس‌های پیشرفته Google Analytics 4AnalyticsDataیاAnalyticsAdminپشتیبانی نمی‌کند. برای پُرسمان داده‌های Google Analytics 4 از یک اسکریپت، درخواست‌های HTTPS را بااستفاده از سرویسUrlFetchAppو OAuth 2.0 به Google Analytics Data API ارسال کنید. همچنین می‌توانید دارایی Google Analytics 4 را به حساب Google Ads خود پیوند دهید تا داده‌های تبدیل وب‌سایت و برنامه را مستقیماً هم‌رسانی کنید. برای دستورالعمل‌های راه‌اندازی، به راهنمای راه‌اندازی Analytics مراجعه کنید. - Google BigQuery
- می‌توانید حجم زیادی از داده‌ها را در Google Cloud Storage بار کنید و سپس بااستفاده از Google BigQuery آن داده‌ها را پُرسمان کنید. برای مثال، می‌توانید داده‌های عمومی آب‌وهوا را برای ۱۰ سال گذشته بار کنید و سپس میانگین دمای منطقه‌ای را در اسکریپتی که از آن اطلاعات برای تنظیم پیشنهادهای قیمت استفاده می‌کند پُرسمان کنید. کاربرد دیگر آن می‌تواند محاسبه داده‌های عملکرد حسابتان درطول چند سال باشد.
- تقویم Google
- دستورگان شما می‌تواند برای کارهای آینده رویداد ایجاد کند (برای مثال، اجرای گزارش عملکرد برای پویش‌هایتان ۲ هفته از امروز)، یا براساس ورودی‌ای که در تقویمتان ایجاد کرده‌اید کنش‌هایی را انجام دهد (برای مثال، فعال کردن پویش در تاریخی خاص).
- اسلایدنگار Google
- دستور شما می‌تواند جزئیات یا آمار پویش را به «اسلایدنگار Google» صادر کند تا چنین اطلاعاتی را در قالبی قابل‌ارائه منتشر کند.
- Google Tasks
- دستورات شما می‌تواند فهرست یادآوری برای تکالیف آینده ایجاد کند (برای مثال، اجرای گزارش عملکرد برای پویش‌هایتان دو هفته از امروز)، یا براساس ورودی‌ای که در فهرست یادآوری‌تان ایجاد کرده‌اید، کنش‌هایی را انجام دهد (برای مثال، فعال کردن پویش در تاریخی خاص).
- Merchant API
- دستورات شما می‌تواند از Merchant API برای بارگذاری و مدیریت فهرستگان محصولتان و مدیریت حساب‌های Google Merchant Center شما استفاده کند. در دستورات، این می‌تواند برای بررسی فهرستگان محصولات و پیوند دادن محصولات خاص به آگهی‌های خاص مفید باشد. Merchant API دارای میاناهای برنامه‌سازی کاربردی فرعی است که می‌توان آن‌ها را به‌طور جداگانه در کادر گفتگوی میاناهای برنامه‌سازی کاربردی پیشرفته فعال کرد. می‌توانید ازطریق راهنمای ثبت‌نام به‌عنوان توسعه‌دهنده، درباره پیوند دادن حساب Google Merchant Center بیشتر بدانید.
- محتوای Shopping
- دست‌نوشته شما می‌تواند از Google Content API for Shopping برای بارگذاری و مدیریت فهرستگان‌های محصول و مدیریت حساب‌های Google Merchant Center شما استفاده کند. در دست‌نوشته‌ها، این کار می‌تواند برای بررسی فهرستگان محصولات و پیوند دادن محصولات خاص به آگهی‌های خاص مفید باشد. توجه: «میانای برنامه‌سازی کاربردی محتوا برای خرید» در تاریخ ۱۸ اوت ۲۰۲۶ غیرفعال خواهد شد. به‌جای آن، از Merchant API که در بخش قبلی توضیح داده شده است استفاده کنید.
- YouTube و YouTube Analytics
- می‌توانید ویدیوها، فهرست‌های پخش، و غیره و همچنین داده‌های عملکرد ویدیوهایتان را برای تصمیم‌گیری درباره پیشنهاد قیمت بازیابی و به‌روز کنید.
فعال کردن میاناهای برنامه‌سازی کاربردی پیشرفته
برای دیدن اینکه کدام میاناهای برنامه‌سازی کاربردی Google به‌عنوان میاناهای برنامه‌سازی کاربردی پیشرفته دردسترس هستند، روی میاناهای برنامه‌سازی کاربردی پیشرفته در نوار ویرایشگر بالا کلیک کنید تا کادر گفتگوی میاناهای برنامه‌سازی کاربردی پیشرفته نمایش داده شود. میاناهای برنامه‌سازی کاربردی‌ای را که می‌خواهید فعال کنید انتخاب کنید.
روی ذخیره کلیک کنید تا انتخاب‌هایتان ذخیره شود و به ویرایشگر دستورات برگردید. میاناهای برنامه‌سازی کاربردی جدید برای دستورات شما فعال خواهد شد و در فهرست تکمیل خودکار دردسترس خواهد بود.
سایر ملاحظات
هنگام کار با APIهای پیشرفته، چند نکته را باید درنظر داشته باشید.
وابستگی‌ها
فقط کاربری که اسکریپت را در حساب ایجاد کرده است می‌تواند وابستگی‌های میاناهای برنامه‌سازی کاربردی پیشرفته را برای آن اسکریپت تغییر دهد.
اجازه‌ها
هنگام دسترسی به میاناهای برنامه‌سازی کاربردی پیشرفته، اسکریپت از اجازه‌های کاربری استفاده می‌کند که
اسکریپت را مجاز کرده است. کاربر صادرکننده مجوز باید دسترسی لازم را به همه
داده‌های موردنیاز اسکریپت داشته باشد. برای مثال، برای استفاده از میانای برنامه‌سازی کاربردی پیشرفته BigQuery،
کاربر مجازکننده باید اجازه‌های لازم را برای پروژه Google Cloud
و مجموعه داده BigQuery هدف داشته باشد.
ملاحظات مربوط به اسکریپت‌های قبل‌از مه ۲۰۱۹
برای اسکریپت‌های ایجادشده قبل‌از مه ۲۰۱۹، ممکن است لازم باشد میاناهای برنامه‌سازی کاربردی مربوطه را به‌صورت دستی در «پروژه Google Cloud» مرتبط با اسکریپت فعال کنید. اگر پیوندی به «کنسول Google Cloud» در کادر گفتگوی میاناهای برنامه‌سازی کاربردی پیشرفته می‌بینید، متوجه خواهید شد که آیا اسکریپت شما تحت تأثیر قرار گرفته است یا نه.
فعال کردن میاناهای برنامه‌سازی کاربردی پیشرفته
برای دستورگان‌های قبل‌از ۲۰۱۹، باید هر میانای برنامه‌سازی کاربردی پیشرفته‌ای را که می‌خواهید در دستورگانتان استفاده کنید به‌طور دستی فعال کنید:
- روی دکمه میاناهای برنامه‌سازی کاربردی پیشرفته کلیک کنید. در پنجره گفتگوی زیر، روی پیوند «کنسول Google Cloud» کلیک کنید.
- اگر پروژه‌تان ازقبل انتخاب نشده است، آن را از فهرست کرکره‌ای «پروژه» انتخاب کنید.
- با وارد کردن نام API در نوار جستجو، API موردنظرتان را برای استفاده در اسکریپت جستجو کنید.
- میانای برنامه‌سازی کاربردی را از نتایج جستجو انتخاب کنید و روی دکمه «فعال کردن» در صفحه بعدی کلیک کنید.
اگر کاربری که اسکریپت را ایجاد کرده است بعداً از حساب برداشته شود، از هر کاربر جدیدی که بخواهد به اسکریپت دسترسی پیدا کند درخواست می‌شود وابستگی‌های API پیشرفته را دوباره فعال کند و همچنین اسکریپت را دوباره مجاز کند.