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