APIهای پیشرفته در اسکریپتهای گوگل ادز به توسعهدهندگان اجازه میدهند تا با تنظیمات کمتری نسبت به استفاده از رابطهای HTTP، به برخی از APIهای عمومی گوگل متصل شوند. شما میتوانید از این APIها بسیار شبیه به سرویسهای داخلی اسکریپتها استفاده کنید و آنها همان امکاناتی مانند تکمیل خودکار و مجوز خودکار را ارائه میدهند.
برای مشاهدهی مثالهایی که نحوهی استفاده از این APIها را نشان میدهند، به صفحهی قطعه کدهای ما مراجعه کنید.
API های پیشرفته موجود
- گوگل آنالیتیکس
- شما میتوانید از گوگل آنالیتیکس برای ردیابی ترافیک وبسایت خود استفاده کنید و پیشنهادات کمپین خود را بر اساس آن تنظیم کنید. اگر یک ویژگی گوگل آنالیتیکس را به حساب گوگل ادز خود پیوند دهید، میتوانید فعالیت مشتری را در وبسایت خود نیز تجزیه و تحلیل کنید. این اطلاعات میتواند میزان ترافیک یا فروش وبسایت شما را از طریق گوگل ادز مشخص کند و به شما در بهبود تبلیغات و وبسایتتان کمک کند. میتوانید از طریق راهنمای مرکز راهنمای راهاندازی آنالیتیکس برای وبسایت و/یا برنامه، درباره پیوند دادن حسابهای آنالیتیکس و گوگل ادز اطلاعات بیشتری کسب کنید.
- گوگل بیگکوئری
- شما میتوانید حجم زیادی از دادهها را در فضای ذخیرهسازی ابری گوگل بارگذاری کنید و سپس با استفاده از Google BigQuery از آن دادهها پرسوجو کنید. به عنوان مثال، میتوانید دادههای عمومی آب و هوا را برای 10 سال گذشته بارگذاری کنید و سپس میانگین دمای یک منطقه را در اسکریپتی که از آن اطلاعات در تنظیم پیشنهادات استفاده میکند، پرسوجو کنید. کاربرد دیگر، انجام محاسبات عددی روی دادههای عملکرد حساب کاربری شما در طول چندین سال است.
- تقویم گوگل
- اسکریپت شما میتواند رویدادهایی را برای وظایف آینده ایجاد کند (برای مثال، گزارش عملکرد کمپینهای شما را ۲ هفته بعد از امروز اجرا کند)، یا بر اساس ورودی که در تقویم خود ایجاد کردهاید، اقداماتی را انجام دهد (برای مثال، یک کمپین را در یک تاریخ خاص فعال کند).
- اسلایدهای گوگل
- اسکریپت شما میتواند جزئیات یا آمار کمپین را به اسلایدهای گوگل منتقل کند تا چنین اطلاعاتی را در قالبی قابل ارائه منتشر کند.
- وظایف گوگل
- اسکریپت شما میتواند یک لیست یادآوری برای کارهای آینده ایجاد کند (برای مثال، دو هفته بعد از امروز، گزارش عملکرد کمپینهای شما را اجرا کند)، یا بر اساس ورودی که در لیست یادآوری خود ایجاد کردهاید، اقداماتی را انجام دهد (برای مثال، یک کمپین را در یک تاریخ خاص فعال کند).
- رابط برنامهنویسی کاربردی (API) فروشنده
- اسکریپت شما میتواند از Merchant API برای آپلود و مدیریت لیست محصولات و مدیریت حسابهای Google Merchant Center شما استفاده کند. در اسکریپتها، این میتواند برای بررسی لیست محصولات و پیوند دادن محصولات خاص به تبلیغات خاص مفید باشد. Merchant API دارای زیرAPIهایی است که میتوانند به صورت جداگانه در کادر گفتگوی Advanced APIs فعال شوند. میتوانید از طریق راهنمای ثبت نام به عنوان توسعهدهنده ، درباره پیوند دادن حساب 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هایی را که میخواهید فعال کنید، تیک بزنید.
سپس، روی لینک Google API Console کلیک کنید تا صفحه API Console در Console به همراه پروژه مرتبط با اسکریپت شما نمایش داده شود؛ یا اگر پروژه شما از قبل انتخاب نشده است، آن را از لیست کشویی Project انتخاب کنید. با وارد کردن نام API در نوار جستجو، APIهایی را که میخواهید در اسکریپت خود استفاده کنید، جستجو کنید.
در نتایج جستجو، API مورد نظر را انتخاب کنید و در صفحه بعد، گزینه فعال کردن (Enable) را انتخاب کنید؛ اگر دکمه غیرفعال کردن (Disable) را مشاهده کردید، یعنی این API از قبل فعال شده است. این کار را برای هر API که میخواهید فعال کنید، تکرار کنید.
برای مشاهده لیست APIهای فعال برای پروژه، صفحه داشبورد را انتخاب کنید. تأیید کنید که تمام APIهای پیشرفتهای که میخواهید برای اسکریپت استفاده کنید، فهرست شدهاند.
اکنون کادر محاورهای Advanced APIs را ببندید تا به ویرایشگر خود بازگردید. APIهای جدید برای اسکریپت شما فعال شده و در لیست تکمیل خودکار در دسترس خواهند بود.
ملاحظات نهایی
هنگام کار با API های پیشرفته، چند نکته وجود دارد که باید در نظر داشته باشید.
شناسه پروژه
هر اسکریپت گوگل ادز یک شناسه پروژه گوگل کلود (که به عنوان شماره پروژه نیز شناخته میشود) دارد که به آن مرتبط است. میتوانید شماره پروژه اسکریپت خود را با باز کردن صفحه کنسول API گوگل از پنجره Advanced APIs پیدا کنید. این شناسه پروژه هنگام ایجاد اسکریپت ایجاد میشود و به کاربری که اسکریپت گوگل ادز را ایجاد کرده است، مرتبط است. اگر کاربری که اسکریپت را ایجاد کرده است بعداً از حساب حذف شود، از کاربری که سعی در دسترسی به اسکریپت دارد، خواسته میشود که اسکریپت را مجدداً تأیید کند و وابستگیهای API پیشرفته را دوباره تنظیم کند. یک شناسه پروژه توسعهدهنده گوگل جدید نیز ایجاد میشود و شما باید APIهای پیشرفته را دوباره تنظیم کنید، همانطور که قبلاً در این سند توضیح داده شده است.
وابستگیها
فقط کاربری که اسکریپت را در حساب کاربری ایجاد کرده است میتواند وابستگیهای APIهای پیشرفته را برای آن اسکریپت تغییر دهد.
مجوزها
هنگام دسترسی به APIها، یک اسکریپت از مجوزهای کاربری که اسکریپت را مجاز کرده است استفاده میکند. مطمئن شوید کاربری که اسکریپت را مجاز کرده است، دسترسی لازم به تمام APIهای پیشرفته مورد استفاده و همچنین دادههایی که اسکریپت نیاز دارد را دارد. اگر از API گوگل آنالیتیکس استفاده میکنید، تأیید کنید که کاربری که اسکریپت را مجاز کرده است، مجوزهای لازم برای دسترسی به حساب آنالیتیکس را دارد.
شرایط و ضوابط
هر یک از APIهای پیشرفته ممکن است شرایط و ضوابط خاص خود را داشته باشند که هنگام فعال کردن API در کنسول API گوگل باید آنها را بپذیرید.
سهمیه
اکثر APIهای پیشرفته دارای سهمیه روزانه رایگان مرتبط با خود هستند. هنگامی که اسکریپت شما از این سهمیه تجاوز کند، API تا زمانی که درخواست داده اضافی نکنید یا سهمیه رایگان دوباره پر نشود، کار خود را متوقف میکند. میتوانید سهمیه استفاده شده توسط اسکریپت خود را با باز کردن کنسول API گوگل برای اسکریپت از کادر محاورهای APIهای پیشرفته ، نظارت کنید . کنسول API گوگل همچنین راهی برای درخواست سهمیه اضافی برای API در اختیار شما قرار میدهد.
صورتحساب
برخی از APIهای پیشرفته از شما میخواهند که برای استفاده از آنها هزینه پرداخت کنید. این پرداختها از طریق پروژه Google Cloud مرتبط با اسکریپت شما مدیریت میشوند و نه از طریق Google Ads. برای جزئیات بیشتر در مورد نحوه فعال کردن پرداخت برای پروژه Google Cloud اسکریپت خود، به مستندات ما مراجعه کنید.