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

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

درخواست ها

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

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

از Content API برای خرید مهاجرت کنید

موارد زیر Content API برای خرید را با Merchant Promotions API برای درخواست‌های مرتبط با تبلیغات مقایسه می‌کند.

URL

در Content API برای خرید:

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

در Merchant API تبدیل می شود:

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

شناسه ها

در Content API برای خرید:

{merchantId}/promotions/{promotionId}

در Merchant API تبدیل می شود:

{name}

مواد و روش ها

Merchant API از روش های زیر برای تبلیغات پشتیبانی می کند:

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

در اینجا مقایسه ای از روش های تبلیغاتی موجود در Content API برای خرید و Merchant API آورده شده است:

روش Content API برای خرید Merchant API
درج کنید آره آره
گرفتن آره آره
فهرست آره آره
دسته سفارشی خیر خیر
حذف خیر (تعیین می شود)

نام منبع

این جدول نشان می دهد که چه تغییراتی برای تبلیغات در API تبلیغات تجاری ایجاد می شود.

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

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

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

در Content API برای خرید، قیمت
یک عدد اعشاری به شکل رشته بود.

مقدار قیمت اکنون در میکرو ثبت می شود،
که در آن 1 میلیون میکرون معادل ارز شماست
واحد استاندارد

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

نام فیلد ارز به تغییر کرده است
کد ارز . قالب به همین صورت باقی می ماند
ISO 4217 . (ویکیپدیا)

order_limit (پشتیبانی نشده) ویژگی order_limit پشتیبانی نمی شود.
shippingServiceNames[] (پشتیبانی نشده) shippingServiceNames[] پشتیبانی نمی شود.
پول_بودجه (پشتیبانی نشده) money_budget پشتیبانی نمی شود.
promotion_destination_ids تبلیغات_مقصد 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,
    ]
    }
  ]
}