API

---

احراز هویت

برای استفاده از Merchant API برای خرید با یک حساب Merchant Center معین، باید یک پروژه API Console راه‌اندازی کنید. پروژه های Google Cloud Console به شما کمک می کند دسترسی API و احراز هویت را برای راه حل Merchant API خود مدیریت کنید.

بسته به نوع استفاده، دو راه برای دسترسی به Merchant API وجود دارد:

• OAuth 2.0 برای دسترسی به یک حساب Merchant Center خاص از طریق برنامه ای که برای کاربران خود ایجاد کرده اید توصیه می شود. کاربر باید اجازه دسترسی به حساب شما را بدهد تا داده ها را از طرف خود ارسال کند.
• حساب سرویس نوع خاصی از حساب است که معمولاً توسط یک برنامه کاربردی به جای یک شخص استفاده می شود. یک حساب کاربری با آدرس ایمیل آن مشخص می شود که مختص آن حساب است.

به نحوه احراز هویت با استفاده از OAuth 2.0 یا یک حساب سرویس مراجعه کنید.

نکته: هنگام ارسال داده‌ها به‌عنوان یک ارائه‌دهنده شراکت فید محلی، ایمیل حساب سرویس باید به فهرست کاربران حساب MCA اضافه شود زیرا تماس‌ها از طریق آن حساب برای همه حساب‌های فرعی MCA احراز هویت می‌شوند.

تنظیمات کشور را فعال کنید

مهم: قبل از ارسال داده های پیشنهادات، باید برنامه محلی خاص را فعال کنید.

با liasettings.update تماس بگیرید تا کشورهایی را که قصد دارید در آنها خدمات محلی ارائه کنید، مشخص کنید.

اطلاعات بیشتر در صفحه هدف تنظیمات کشور

ارسال داده های پیشنهادات

دو نوع داده وجود دارد: داده محصول و موجودی.

داده های محصول و موجودی را به یکباره ارسال کنید

داده های محصول و موجودی را می توان با استفاده از accounts.lfpInventories.insert یکباره ارسال کرد

فیلد "GTIN" در واقع به عنوان یک شناسه محصول برای کاتالوگ Google کار می کند و یک فید محصول به طور خودکار ایجاد می شود.

این فید ایجاد شده به‌طور خودکار در Merchant Center هدف به‌عنوان فید «ارائه‌دهنده خوراک محلی» همراه با پیشنهادات مربوطه نشان داده می‌شود.

اگر همه محصولات تاجر GTIN داشته باشند و هیچ ویژگی دیگری فعال نشود، این روش به خوبی کار می کند (مانند فروشگاه محلی Merchant Hosted Local Front Basic). اگر قصد دارید MHLSF را برای بازرگانان خود فعال کنید، ارسال یک فید محصول اختصاصی توصیه می‌شود.

همین رویه می تواند با استفاده از accounts.lfpSales.insert کار کند

در این مورد، داده ها به یک رویداد فروش برای یک محصول خاص در یک زمان خاص اشاره دارد.

اطلاعات محصول و موجودی را جداگانه ارسال کنید

اگر GTIN ها به طور گسترده در دسترس نیستند یا ترجیح می دهید از یک فید محصول موجود در حساب مرکز تجاری هدف استفاده کنید یا می خواهید MHLSF را برای بازرگانان خود فعال کنید، باید یک فید محصول محلی خاص داشته باشید.

این را می توان با فراخوانی accounts.productInputs.insert ابتدا و درج تمام مقادیر ثابت یک محصول فعال کرد. به یاد داشته باشید که ویژگی Channel را روی "local" تنظیم کنید.

در این مقاله و راهنمای کلی API برای درج محصولات، اطلاعات اولیه محصول را بیاموزید.

جریان داده به شرح زیر است:

• ابتدا با accounts.productInputs.insert تماس بگیرید تا بارگذاری محصولات را برای تاجران خود آغاز کنید
• سپس برای ارسال داده های موجودی ، accounts.lfpInventories.insert را فراخوانی کنید.

همچنین، داده‌های موجودی را می‌توان از طریق accounts.lfpSales.insert ارسال کرد. سپس یک مدل یادگیری ماشینی قیمت و مقدار پیشنهادات را بر اساس این داده ها پیش بینی می کند.

نمونه نمای کلی برای accounts.lfpInventories.insert, accounts.lfpSales.insert accounts.lfpStores.insert

مهم: پیشنهاد Id ارسال شده در accounts.productInputs.insert باید با offerId در accounts.lfpInventories.insert مطابقت داشته باشد تا پیشنهادات به درستی ترسیم شوند.

مهم: accounts.lfpInventories.insert دارای یک پارامتر والد در URL است. این حساب ارائه دهنده LFP شما است که توسط تیم پشتیبانی فعال شده است. حساب مرکز تجاری خرده‌فروش شما در محموله درخواستی است که به‌عنوان TargetMerchant شناخته می‌شود. این شناسه مرکز تجاری تاجر برای ارسال موجودی است.

نکته کلیدی: داده های محصول در 30 روز منقضی می شود و داده های موجودی در 14 روز منقضی می شود. این در حذف محصولات ناخواسته موثر است. در صورتی که GTIN برای همه پیشنهادات شناخته شده باشد، می‌توان با استفاده از accounts.lfpInventories.insert ، داده‌های محصول و موجودی را هم‌زمان ارسال کرد. همچنین می‌توانید از accounts.productInputs.insert برای داده‌های محصول و accounts.lfpInventories.insert (یا accounts.lfpSales.insert ) برای داده‌های موجودی استفاده کنید.

ارسال اطلاعات نمایه کسب و کار

وقتی دسترسی به حساب Google Business Profile تاجر برای بازیابی کدهای فروشگاه ممکن نباشد، داده‌های فروشگاه را می‌توان از طریق accounts.lfpStores.insert با کدهای فروشگاه خاص شما ارسال کرد.

توجه داشته باشید که هنگام فراخوانی accounts.lfpinventories.insert یا accounts.lfpSales.insert، کد فروشگاه باید با کد فروشگاه ارائه شده در درخواست‌های lfp Stores مطابقت داشته باشد.

مهم: اگر فروشگاهی منطبق پیدا نشد، از موجودی‌ها یا فروش‌های ارسال شده با کد فروشگاه استفاده نمی‌شود. برای موفقیت در نرخ تطابق بالاتر، اطلاعات ارائه شده باید دقیقاً با جزئیات موجود در Google Maps برای آن فروشگاه خاص مطابقت داشته باشد.

پاسخ accounts.lfpStores.insert همچنین یک matchingState و matchingStateHint در صورت عدم تطابق ارائه می دهد.

نکته: باید آن پاسخ‌ها را زیر نظر داشته باشید تا مشکلات تطابق را زودتر ثبت کنید و آنها را برطرف کنید و از ایجاد فروشگاه‌های بی‌همتا خودداری کنید، زیرا در موقعیتی نیستند که پیشنهادات برای آنها ارائه شود.