این راهنما برخی‌از روال‌های مطلوبی را که می‌توانید برای بهینه‌سازی کارایی و عملکرد برنامه‌هایتان پیاده‌سازی کنید پوشش می‌دهد.
نگهداری از برنامه
برای اطمینان از اینکه برنامه‌تان بدون وقفه اجرا می‌شود، کارهای زیر را انجام دهید:
مطمئن شوید که فهرست مالکان و ویرایشگران پروژه Google Cloud شما به‌روز است. درصورت بروز هرگونه شرایط اضطراری یا موضوعات مربوط به رعایت «شرایط خدمات میانای برنامه‌سازی کاربردی»، با این کاربران تماس خواهیم گرفت. اگر نتوانیم درباره رعایت «شرایط خدمات» API با شما تماس بگیریم، ممکن است دسترسی شما به API کاهش یابد یا لغو شود.
برای مطلع شدن از مسائلی مثل تغییرات محصول، زمان ازکارافتادگی برای تعمیر و نگهداری، و تاریخ‌های منسوخ شدن، در وبلاگ API و وبلاگ محصول ما مشترک شوید.
برنامه‌تان را با شرایط خدمات Google Ads API مطابقت دهید. درصورت لزوم، تیم رعایت مقررات API با مالکان و ویرایشگران پروژه Google Cloud شما که دسترسی API دارند تماس خواهد گرفت. اگر درباره «شرایط خدمات» سؤال یا نگرانی دارید، می‌توانید با پاسخ دادن به ایمیلی که تیم رعایت مقررات هنگام بررسی درخواست دسترسی به میانای برنامه‌سازی کاربردی برایتان ارسال کرده است، با آن‌ها تماس بگیرید.
بهینه‌سازی
می‌توانید با اجرای عملیات دسته‌ای و، درصورت لزوم، ارسال اشیای پراکنده، برنامه‌تان را بهینه‌سازی کنید.
عملیات گروهی
ارسال درخواست به «میانای برنامه‌سازی کاربردی» مستلزم تعدادی هزینه ثابت است، مانند تأخیر شبکه رفت‌وبرگشت، پردازش سریال‌سازی و سریال‌زدایی، و تماس با سیستم‌های پسین. برای کاهش تأثیر این هزینه‌های ثابت و افزایش عملکرد کلی، اکثر روش‌های تغییر در میانای برنامه‌سازی کاربردی به‌گونه‌ای طراحی شده‌اند که آرایه‌ای از عملیات را بپذیرند. با دسته‌بندی کردن چندین عملیات در هر درخواست، می‌توانید تعداد درخواست‌هایی را که ایجاد می‌کنید و هزینه‌های ثابت مرتبط را کاهش دهید. درصورت امکان، از ایجاد درخواست‌هایی که فقط یک عملیات دارند خودداری کنید.
برای مثال، فرض کنید می‌خواهید ۵۰٬۰۰۰ کلیدواژه را به پویشی در چندین گروه آگهی اضافه کنید. به‌جای اینکه ۵۰٬۰۰۰ درخواست با ۱ کلیدواژه برای هرکدام ایجاد کنید، ۱۰۰ درخواست با ۵۰۰ کلیدواژه برای هرکدام، یا حتی ۱۰ درخواست با ۵٬۰۰۰ کلیدواژه برای هرکدام ایجاد کنید. تعداد عملیات مجاز در یک درخواست محدود است، بنابراین ممکن است لازم باشد اندازه دسته‌تان را برای دستیابی به عملکرد بهینه تنظیم کنید.
ارسال اشیاء پراکنده
وقتی اشیا به API ارسال می‌شوند، فیلدها باید غیرسریالی، معتبر، و در پایگاه داده ذخیره شوند. ارسال اشیاء کامل وقتی فقط می‌خواهید چند فیلد را به‌روز کنید می‌تواند منجر به زمان پردازش اضافی و کاهش عملکرد شود. برای کاهش این مشکل، Google Ads API از به‌روزرسانی‌های پراکنده پشتیبانی می‌کند و به شما امکان می‌دهد فقط فیلدهایی را در شیء پر کنید که نیاز به تغییر دارند یا الزامی هستند.
به‌روزرسانی‌های پراکنده سریع‌تر پردازش می‌شوند و احتمال بروز خطا در آن‌ها کمتر است. فیلدهایی که
در update_mask (که با نام FieldMask نیز شناخته می‌شود) نیستند بدون تغییر باقی می‌مانند.
برای مثال، برنامه‌ای که پیشنهادهای قیمت سطح کلیدواژه را به‌روز می‌کند می‌تواند از به‌روزرسانی‌های پراکنده بهره‌مند شود، زیرا فقط فیلدهای شناسه گروه آگهی، شناسه معیار، و پیشنهادهای قیمت باید پر شوند.
مدیریت و رسیدگی به خطا
درطول توسعه، احتمالاً با خطاهایی مواجه خواهید شد. این بخش ملاحظات و استراتژی‌های مربوط به ایجاد مدیریت خطا در برنامه را شرح می‌دهد. علاوه‌بر این بخش، برای کسب اطلاعات بیشتر درباره مدیریت خطاها، به راهنمای عیب‌یابی مراجعه کنید.
تشخیص منابع درخواست
برخی‌از برنامه‌ها در درجه اول تعاملی هستند و مستقیماً در پاسخ به کنش‌های آغازشده توسط کاربر در میانای کاربر، فراخوانی‌های API صادر می‌کنند. برخی‌از آن‌ها عمدتاً به‌صورت آفلاین کار می‌کنند و فراخوانی‌های API را به‌عنوان بخشی از فرایند دوره‌ای پس‌زمینه صادر می‌کنند. بسیاری از برنامه‌ها این دو را ترکیب می‌کنند. هنگام فکر کردن درباره مدیریت خطا، تشخیص این انواع مختلف درخواست‌ها می‌تواند مفید باشد.
برای درخواست‌های آغازشده توسط کاربر، نگرانی اصلی شما باید ارائه تجربه خوب برای کاربرانتان باشد. از خطای خاصی که رخ داده است استفاده کنید تا در واسط کاربر تا جایی که می‌توانید زمینه را برای کاربر فراهم کنید. مراحل واضحی را که می‌توانند برای رفع خطا انجام دهند ارائه دهید (پیشنهادهای زیر را ببینید).
برای درخواست‌هایی که در پس‌نما آغاز شده‌اند، گرداننده‌هایی برای انواع مختلف خطاهایی که ممکن است برنامه‌تان با آن‌ها مواجه شود پیاده‌سازی کنید. همیشه یک کنترل‌کننده پیش‌فرض برای رسیدگی به خطاهای نادر یا خطاهایی که قبلاً با آن‌ها مواجه نشده‌اید اضافه کنید. یک رویکرد خوب برای یک گرداننده پیش‌فرض این است که عملیات ناموفق و خطا را به یک صف اضافه کند تا یک اپراتور انسانی آن را بررسی کند و راه‌حل مناسبی را تعیین کند.
تشخیص انواع خطا
دانستن تفاوت‌های بین انواع خطا در Google Ads API هنگام ساختن مدیریت خطای قوی بسیار مهم است. برخی‌از رایج‌ترین انواع خطا عبارت‌اند از:
برای جزئیات بیشتر، به انواع خطا و خطاهای رایج مراجعه کنید.
همگام‌سازی باطن‌ها
اگر کاربران برنامه‌تان دسترسی دستی به حساب‌های Google Ads داشته باشند، ممکن است تغییراتی ایجاد کنند که برنامه‌تان از آن‌ها مطلع نباشد و باعث شود پایگاه داده محلی برنامه‌تان از همگام‌سازی خارج شود. همان‌طور که در راهنمای انواع خطا ما ذکر شده است، می‌توانید
خطاهای مربوط به همگام‌سازی را به‌صورت واکنشی هنگام وقوع آن‌ها برطرف کنید، اما می‌توانید
به‌صورت پیش‌گیرانه نیز برای جلوگیری از آن‌ها تلاش کنید. یک راهبرد پیش‌گیرانه این است که کار همگام‌سازی دوره‌ای را اجرا کنید تا
پایگاه داده محلی‌تان را با اشیای Google Ads در حساب‌هایتان تطبیق دهید. برای
سلسله‌مراتب حساب‌های بزرگ، از کشیدن همه اشیا در هر حساب
به‌صورت شبانه خودداری کنید تا سهمیه‌های روزانه تمام نشود؛ به‌جای آن،
ChangeStatus را پُرسمان کنید یا موجودیت‌های اخیراً اصلاح‌شده را فیلتر کنید تا
تغییرات به‌صورت افزایشی همگام‌سازی شود.
خطاهای گزارش
همه خطاها باید ثبت شوند تا اشکال‌زدایی و نظارت تسهیل شود. حداقل شناسه درخواست، عملیاتی که باعث خطا شده است، و خود خطا را ثبت کنید. اطلاعات دیگری که باید ثبت شود شامل شناسه مشتری، سرویس API، تأخیر درخواست رفت‌وبرگشت، تعداد تلاش‌های مجدد، و درخواست و پاسخ خام پاک‌سازی‌شده است (مطمئن شوید که اطلاعات کاربری حساس مانند توکن‌های OAuth و هرگونه اطلاعات شناساننده شخصی را پنهان کنید).
پایش گرایش‌ها
حتماً روندهای خطاهای میانای برنامه‌سازی کاربردی را پایش کنید تا بتوانید مشکلات برنامه‌تان را شناسایی و برطرف کنید. می‌توانید راهکار خودتان را بسازید یا از یکی از ابزارهای تجاری موجود استفاده کنید که می‌توانند از گزارش‌های شما برای تولید داشبوردهای تعاملی و ارسال هشدارهای خودکار استفاده کنند.
توسعه
درطول توسعه از حساب‌های آزمایشی استفاده کنید.
استفاده از حساب‌های آزمایشی
حساب‌های آزمایشی حساب‌های Google Ads هستند که درواقع آگهی ارائه نمی‌کنند. می‌توانید از حساب آزمایشی برای آزمایش Google Ads API استفاده کنید و مطمئن شوید که اتصال‌پذیری، منطق مدیریت پویش، یا پردازش‌های دیگر برنامه‌تان طبق انتظار کار می‌کند. پروژه Google Cloud شما فقط به دسترسی «آزمایشی» نیاز دارد تا در حساب آزمایشی استفاده شود، بنابراین می‌توانید بلافاصله توسعه را با Google Ads API شروع کنید، درحالی‌که منتظر هستید Google درخواست شما را برای سطوح دسترسی بالاتر به API بررسی کند.