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

می‌توانید از 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,
    ]
    }
  ]
}