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