میاناهای برنامه‌سازی کاربردی پیشرفته در جاوااسکریپت Google Ads به توسعه‌دهندگان اجازه می‌دهد با راه‌اندازی کمتری نسبت به استفاده از میاناهای HTTP به میاناهای برنامه‌سازی کاربردی عمومی Google متصل شوند. می‌توانید از این میاناهای برنامه‌سازی کاربردی مانند سرویس‌های داخلی اسکریپت‌ها استفاده کنید و آن‌ها همان راحتی‌ها را مانند تکمیل خودکار و مجوزدهی خودکار ارائه می‌دهند.
برای دیدن چند نمونه که نحوه استفاده از این میاناهای برنامه‌سازی کاربردی را نشان می‌دهد، به صفحه تکه‌کدهای ما مراجعه کنید.
میاناهای برنامه‌سازی کاربردی پیشرفته دردسترس
- Google Analytics
- می‌توانید از Google Analytics برای ردیابی ترافیک ورودی به وب‌سایتتان استفاده کنید و پیشنهادهای قیمت پویشتان را براساس آن تنظیم کنید. اگر دارایی Google Analytics را به حساب Google Ads خود پیوند دهید، می‌توانید فعالیت مشتری را در وب‌سایت خود نیز تجزیه‌وتحلیل کنید. این اطلاعات می‌تواند مشخص کند که چه مقدار از ترافیک یا فروش وب‌سایت شما از Google Ads حاصل می‌شود و به شما کمک کند تا آگهی‌ها و وب‌سایت خود را بهبود بخشید. می‌توانید درباره پیوند دادن حساب‌های Analytics و 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های پیشرفته، چند نکته را باید درنظر داشته باشید.
وابستگی‌ها
فقط کاربری که اسکریپت را در حساب ایجاد کرده است می‌تواند وابستگی‌های میاناهای برنامه‌سازی کاربردی پیشرفته را برای آن اسکریپت تغییر دهد.
اجازه‌ها
هنگام دسترسی به میاناهای برنامه‌سازی کاربردی، اسکریپت از اجازه‌های کاربری استفاده می‌کند که اسکریپت را مجاز کرده است. مطمئن شوید کاربری که اسکریپت را مجاز کرده است دسترسی لازم را به همه داده‌های موردنیاز اسکریپت داشته باشد. اگر از Google Analytics API استفاده می‌کنید، بررسی کنید کاربری که به اسکریپت اجازه داده است، اجازه‌های لازم را برای حساب Analytics که به آن دسترسی پیدا می‌کند داشته باشد.
ملاحظات مربوط به اسکریپت‌های قبل‌از مه ۲۰۱۹
برای اسکریپت‌های ایجادشده قبل‌از مه ۲۰۱۹، ممکن است لازم باشد میاناهای برنامه‌سازی کاربردی مربوطه را به‌صورت دستی در «پروژه Google Cloud» مرتبط با اسکریپت فعال کنید. اگر پیوندی به «کنسول Google Cloud» در کادر گفتگوی میاناهای برنامه‌سازی کاربردی پیشرفته می‌بینید، متوجه خواهید شد که آیا اسکریپت شما تحت تأثیر قرار گرفته است یا نه.
فعال کردن میاناهای برنامه‌سازی کاربردی پیشرفته
برای دستورگان‌های قبل‌از ۲۰۱۹، باید هر میانای برنامه‌سازی کاربردی پیشرفته‌ای را که می‌خواهید در دستورگانتان استفاده کنید به‌طور دستی فعال کنید:
- روی دکمه میاناهای برنامه‌سازی کاربردی پیشرفته کلیک کنید. در پنجره گفتگوی زیر، روی پیوند «کنسول Google Cloud» کلیک کنید.
- اگر پروژه‌تان ازقبل انتخاب نشده است، آن را از فهرست کرکره‌ای «پروژه» انتخاب کنید.
- با وارد کردن نام API در نوار جستجو، API موردنظرتان را برای استفاده در اسکریپت جستجو کنید.
- میانای برنامه‌سازی کاربردی را از نتایج جستجو انتخاب کنید و روی دکمه «فعال کردن» در صفحه بعدی کلیک کنید.
اگر کاربری که اسکریپت را ایجاد کرده است بعداً از حساب برداشته شود، از هر کاربر جدیدی که بخواهد به اسکریپت دسترسی پیدا کند درخواست می‌شود وابستگی‌های API پیشرفته را دوباره فعال کند و همچنین اسکریپت را دوباره مجاز کند.