مدیریت تبلیغات مهاجرت

شما می‌توانید از رابط برنامه‌نویسی کاربردی (API) تبلیغات فروشندگان (Merchant Promotions API) برای ایجاد و مدیریت تبلیغات در گوگل استفاده کنید. منبع accounts.promotions به شما امکان می‌دهد پیشنهادات ویژه‌ای را برای محصولاتی که در گوگل می‌فروشید، نمایش دهید. برای اطلاعات بیشتر، به «مروری بر API تبلیغات فروشندگان» مراجعه کنید.

مروری بر تغییرات از API محتوا برای خرید به API فروشنده

یک تفاوت قابل توجه این است که Content API for Shopping به طور خودکار منبع داده را پس از اولین درج تبلیغ ایجاد می‌کند، که در Merchant API این اتفاق نمی‌افتد. برای درج یک تبلیغ با استفاده از Merchant API، ابتدا باید یک منبع داده promotions ایجاد کنید . برای اطلاعات در مورد فیلدهای شیء promotionDataSource در منبع accounts.dataSources ، به PromotionDataSource مراجعه کنید.

درخواست‌ها

برای درخواست، از آدرس اینترنتی زیر استفاده کنید.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

مهاجرت از API محتوا برای خرید

در ادامه، رابط برنامه‌نویسی کاربردی محتوا (Content API) برای خرید (Shopping) با رابط برنامه‌نویسی کاربردی تبلیغات فروشنده (Merchant Promotions API) برای درخواست‌های مرتبط با تبلیغات مقایسه می‌شود.

آدرس اینترنتی

در رابط برنامه‌نویسی کاربردی محتوا برای خرید:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

در Merchant API به صورت زیر می‌شود:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

شناسه‌ها

در رابط برنامه‌نویسی کاربردی محتوا برای خرید:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

در Merchant API به صورت زیر می‌شود:

{NAME}

روش‌ها

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) از روش‌های زیر برای تبلیغات پشتیبانی می‌کند:

  • درج تبلیغات
  • دریافت تبلیغات
  • فهرست تبلیغات

در اینجا مقایسه‌ای از روش‌های تبلیغاتی موجود در API محتوا برای خرید و API فروشنده ارائه شده است:

ویژگی API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده
آدرس اینترنتی https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /promotions https://merchantapi.googleapis.com/promotions/v1/ {parent=accounts/*} /promotions
شناسه‌ها {MERCHANT_ID} /promotions/ {PROMOTION_ID} {NAME}
روش‌ها
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

تغییرات میدانی

جدول نشان می‌دهد که چه تغییراتی برای بخش تبلیغات در رابط برنامه‌نویسی کاربردی (API) تبلیغات فروشندگان ایجاد شده است.

برای دیدن یک مثال به عنوان مرجع، به فهرست موجودی محلی مراجعه کنید.

API محتوا برای خرید رابط برنامه‌نویسی کاربردی (API) فروشنده توضیحات
(پشتیبانی نمی‌شود) ویژگی‌های_سفارشی فهرستی از ویژگی‌های سفارشی (ارائه شده توسط کاربر). شما می‌توانید
همچنین از آن برای ارسال هر ویژگی از فید استفاده کنید
مشخصات در شکل عمومی آن.
برای مثال:
{
  "name": "size type", "value": "regular"
}
این برای ارسال ویژگی‌ها به صورت غیرصریح مفید است.
توسط API افشا شده است.
پشتیبانی نمی‌شود منبع داده ایجاد یک پروموشن نیاز به یک منبع داده موجود دارد.
پشتیبانی نمی‌شود ویژگی‌ها ویژگی‌های خاص تبلیغات، برای مثال،
کاشی_طولانی ، دوره_زمانی_موثر_ارتقاء ،
و موارد دیگر، بخشی از پیام ویژگی هستند.
شناسه آیتم item_id_inclusion فهرست شناسه‌های اقلامی که یک پیشنهاد ویژه روی آنها اعمال می‌شود
به تغییر نام داده است.
شناسه فروشگاه store_id_inclusion فهرست شناسه‌های فروشگاه‌هایی که یک پیشنهاد ویژه روی آنها اعمال می‌شود
به تغییر نام داده است.
نوع_محصول نوع_محصول_شامل فهرست انواع محصولاتی که یک پروموشن روی آنها اعمال می‌شود
به تغییر نام داده است.
شناسه_گروه_مورد شناسه_گروه_مورد_گنجانش فهرست شناسه‌های گروه‌های کالایی که یک پیشنهاد ویژه روی آنها اعمال می‌شود
به تغییر نام داده است.
برند شمول برند لیست برندهایی که یک پروموشن برایشان اعمال می‌شود
به تغییر نام داده است.
کد فروشگاه کدهای فروشگاه فهرست کدهای فروشگاهی که یک پروموشن روی آنها اعمال می‌شود
به تغییر نام داده است. 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
تعریف قیمت تغییر کرده است.

در رابط برنامه‌نویسی کاربردی محتوا برای خرید، قیمت
یک عدد اعشاری به شکل رشته بود.

مبلغ قیمت اکنون به صورت میکرو ثبت می‌شود،
که در آن ۱ میلیون میکرو معادل پول رایج شماست
واحد استاندارد.

نام فیلد مقدار از مقدار به مقدار تغییر کرده است
مقدارمیکرو

نام فیلد ارز به تغییر یافته است
currencyCode . قالب به صورت زیر باقی می‌ماند.
ایزو ۴۲۱۷ (ویکی‌پدیا)

محدودیت سفارش (پشتیبانی نمی‌شود) ویژگی order_limit پشتیبانی نمی‌شود.
نام‌های سرویس حمل و نقل[] (پشتیبانی نمی‌شود) shippingServiceNames[] پشتیبانی نمی‌شود.
بودجه_پول (پشتیبانی نمی‌شود) money_budget پشتیبانی نمی‌شود.
شناسه‌های_مقصد_تبلیغاتی مقاصد_تبلیغاتی promotionDestinationIds تغییر نام داده است.
وضعیت تبلیغات
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
وضعیت تبلیغات تغییر کرده است.
جزئیات بیشتر در سطح جزئیات در شماره‌ها موجود است. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}