Address Validation API در Google Sheets

هدف

در این سند، نحوه استفاده از Address Validation API در Google Sheets را بررسی خواهیم کرد تا سرویس را به روشی سریع و آسان آزمایش کنیم.

به‌عنوان یک غیرتوسعه‌دهنده، در حالی که مایلید با داده‌هایی که از پلتفرم نقشه‌های Google مانند Address Validation API کار می‌کنند، بخواهید راهی برای شروع کار با این سرویس بدون کمک بیش از حد از تیم‌های فنی پیدا کنید.

موارد استفاده کنید

اکنون بیایید موارد استفاده را که در آن Address Validation API در Google Sheets مفید است، درک کنیم:

• آزمایشی : به عنوان یک کسب و کار ممکن است بخواهید به سرعت قابلیت های Address Validation API را با استفاده از آدرس های خود آزمایش کنید.
• مقایسه : نتایج Address Validation API را با نتایج دیگر نقاط پایانی مانند Geocoding API یا Places API مقایسه کنید.
• تست A/B : تغییرات A/B یک مجموعه داده را آزمایش کنید تا بفهمید چه چیزی ممکن است نتایج مناسب تری ارائه دهد.
  

قالب Google Sheets

راه حل، یک برگه Google است که با توابع سفارشی Apps Script ارائه می‌شود که درخواست‌ها را به ترتیب به Address Validation API انجام می‌دهد.

نکته: این مثال فقط برای راهنمایی یکپارچه سازی است. قبل از استفاده با برنامه های خود باید از کیفیت اطمینان حاصل کنید. پشتیبانی در محصولاتی مانند Address Validation API که در این مثال استفاده شده است در دسترس است.

می‌توانید آدرس‌ها را با دنبال کردن مراحل زیر توسط API اجرا کنید (به یک حساب Google و یک کلید API نیاز دارد):

1. به صفحه گسترده نمونه بروید و از منو انتخاب کنید: File > Make a copy
   (شما باید به حساب Google خود وارد شوید یا یک حساب ایجاد کنید)
   
2. Address Validation API را فعال کنید و یک کلید API از Cloud Console ایجاد کنید.
   
3. در برگه برگه‌های «کلید API + داشبورد»، سلول B2 را با کلید API خود جایگزین کنید.
   
4. آدرس‌ها را در الگو کپی/پیست کنید (در یک برگه جداگانه برای قالب‌بندی داده‌ها: شماره خیابان، نام، شهر، کدپستی را به هم متصل کنید)
   
5. سلول‌های برگه‌ها را انتخاب کنید و سپس از منوی "Address Validation" > "Address Validation selection API" را انتخاب کنید.
   
6. در اولین اجرا، یک پیام "Authorization Required" ظاهر می شود تا دسترسی به Apps Script را فراهم کند.
   

احتیاط: کلید API خود را با محدود کردن استفاده از آن فقط به Address Validation API ایمن کنید. برای جلوگیری از استفاده غیرمنتظره، مطمئن شوید که برگه خود را فقط با اشخاص معتمد به اشتراک بگذارید و پس از اتمام تحلیل، کلید خود را در کنسول حذف کنید.

نکته: برای مطابقت با شرایط پلتفرم نقشه های Google، مطمئن شوید که صفحه گسترده را پس از 30 روز حذف کنید زیرا کاربرگ‌نگار Google دارای سابقه داخلی است.

شرایط پلتفرم نقشه های گوگل

این راه حل برای اهداف آزمایشی در مجموعه محدودی از آدرس‌ها ارائه شده است: مدت زمان ذخیره در حافظه پنهان: 30 روز متوالی تقویمی، پس از آن مشتری باید (1) محتوای حافظه پنهان Google Maps را حذف کند یا (2) با داده‌های کاربر نهایی ارائه شده از طریق تأیید کاربر نهایی جایگزین شود. یا اصلاح به جدول 11.3.1 شرایط خدمات پلتفرم Google Maps (مجوزهای ذخیره سازی) مراجعه کنید:

• شناسه مکان
  
• مکان: مقادیر عرض جغرافیایی، مقادیر طول جغرافیایی
  
• حکم
  
• آدرس فرمت شده
  
• آدرس پستی
  
• addressComponent: componentName
  
• آدرس استاندارد داده USPS
  

ملاحظات

• عملکرد: در تکه های 1000 ردیفی و نه بیشتر به یکباره ادامه دهید. اسکریپت در نهایت می تواند متوقف شود، برای مثال زمانی که از سهمیه API در ثانیه فراتر می رود، از ردیفی که اسکریپت متوقف شده است ادامه یابد.
• می‌توانید از منو > برنامه‌های افزودنی > اسکریپت برنامه‌ها به کد دسترسی داشته باشید و نسخه خود را از اسکریپت متناسب با نیاز خود بسازید.
• قیمت گذاری برای Address Validation API.

نتیجه گیری

Address Validation API در Google Sheets به غیر توسعه‌دهندگان اجازه می‌دهد تا از Address Validation API جست‌وجو کنند و بفهمند که چگونه می‌تواند برای کسب و کارشان استراتژیک باشد. این سند تلاش می‌کند تا نشان دهد که چگونه هر کسی می‌تواند با ایجاد یک کلید API و استفاده از الگوی Google Sheets، پرس‌وجو از API را آغاز کند.

اقدامات بعدی

پیشنهاد برای مطالعه بیشتر:

• اعتبار سنجی آدرس برای تسویه حساب تجارت الکترونیک
• کتابخانه اعتبارسنجی آدرس با حجم بالا

مشارکت کنندگان

گوگل این مقاله را حفظ می کند. مشارکت کنندگان زیر در ابتدا آن را نوشتند.
نویسنده اصلی:

توماس آنگلرت | مهندس راه حل\