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

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

نمای کلی تغییرات از Content API for Shopping به Merchant API

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

درخواست ها

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

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

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

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

URL

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

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

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

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

شناسه ها

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

{MERCHANT_ID}/promotions/{PROMOTION_ID}

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

{NAME}

روش ها

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

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

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

ویژگی Content API برای خرید Merchant API
URL 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 تبلیغات تجاری ایجاد می شود.

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

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 فهرست شناسه‌های فروشگاهی که تبلیغی اعمال می‌شود
به تغییر نام می یابد.
محصول_نوع محصول_نوع_شامل فهرست انواع محصولاتی که یک تبلیغ اعمال می شود
به تغییر نام می یابد.
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,
    ]
    }
  ]
}