انتقال مدیریت تبلیغات

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

نمای کلی تغییرات از «میانای برنامه‌سازی کاربردی محتوا برای خرید» به «میانای برنامه‌سازی کاربردی بازرگان»

تفاوت مهم این است که Content API for Shopping به‌طور خودکار منبع داده را هنگام اولین درج تبلیغ ایجاد می‌کند، که این اتفاق در Merchant API نمی‌افتد. برای درج کردن عرضه ترویجی بااستفاده از Merchant API، ابتدا باید منبع داده عرضه‌های ترویجی ایجاد کنید.

برای اطلاعات درباره فیلدهای شیء promotionDataSource در منبع accounts.dataSources، به PromotionDataSource مراجعه کنید.

منابع داده موجود

برای منابع داده موجود، اگر accounts.dataSources.name خود را نمی‌دانید، از dataSources.list برای بازیابی آن استفاده کنید.

یا می‌توانید منبع داده را برای هریک از تبلیغ‌هایتان بااستفاده از روش accounts.promotions.get و بررسی فیلد dataSource در پاسخ هر تبلیغ موجود در حسابتان شناسایی کنید.

برای ارجاع مستقیم به آن‌ها در فراخوانی‌های میانای برنامه‌سازی کاربردی در آینده، اکیداً توصیه می‌کنیم accounts.dataSources.name را در پایگاه داده محلی‌تان برای هر تبلیغ ذخیره کنید.

درخواست‌ها

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

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

انتقال از Content API ویژه Shopping

در ادامه، Content API ویژه Shopping با Merchant Promotions API برای درخواست‌های مربوط به تبلیغات مقایسه شده است.

نشانی وب

در Content API ویژه Shopping:

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

در «میانای برنامه‌سازی کاربردی بازرگان» به این صورت می‌شود:

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

شناسه‌ها

در Content API ویژه Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

در «میانای برنامه‌سازی کاربردی بازرگان» به این صورت می‌شود:

{NAME}

روش‌ها

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

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

در اینجا مقایسه‌ای از دردسترس بودن روش‌های تبلیغ در Content API for Shopping و Merchant API ارائه شده است:

ویژگی Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده
نشانی وب 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

تغییرات فیلد

این جدول نشان می‌دهد که چه تغییراتی برای «عرضه‌های ترویجی» در Merchant Promotions API ایجاد می‌شود.

برای دیدن نمونه‌ای برای مرجع، accounts.promotions را ببینید.

Content API for Shopping میانای برنامه‌سازی کاربردی فروشنده شرح
(پشتیبانی نمی‌شود) custom_attributes فهرستی از مشخصه‌های سفارشی (ارائه‌شده توسط کاربر). می‌توانید
از آن برای ارسال هر مشخصه از مشخصات فید
در شکل عمومی آن نیز استفاده کنید.
برای مثال: 
{
  "name": "size type", "value": "regular"
}
این مورد برای ارسال مشخصه‌هایی مفید است که به‌طور صریح
توسط میانای برنامه‌سازی کاربردی نشان داده نشده‌اند.
پشتیبانی نمی‌شود data_source برای ایجاد تبلیغ، به منبع داده موجود نیاز است.
پشتیبانی نمی‌شود مشخصه‌ها مشخصه‌های خاص تبلیغ، برای مثال،
long_tile، promotion_effective_timeperiod،
و موارد دیگر، بخشی از پیام مشخصه هستند.
item_id item_id_inclusion فهرست شناسه‌های موردی که تبلیغی به آن اعمال می‌شود
تغییر نام داده است.
store_id store_id_inclusion فهرست شناسه‌های فروشگاهی که تبلیغی به آن اعمال می‌شود
تغییر نام داده است.
product_type product_type_inclusion فهرست انواع محصولی که تبلیغ ویژه به آن‌ها اعمال می‌شود
تغییر نام داده است.
item_group_id item_group_id_inclusion فهرست شناسه‌های گروه موردی که تبلیغی به آن اعمال می‌شود
تغییر نام داده است.
brand brand_inclusion فهرست نمانام‌هایی که تبلیغ به آن‌ها اعمال می‌شود
تغییر نام داده است.
store_code store_codes_inclusion فهرست کدهای فروشگاهی که تبلیغی برای آن اعمال می‌شود
تغییر نام داده است. 
price:
  {
    object (Price)
  }

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

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

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

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

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

order_limit (پشتیبانی نمی‌شود) از مشخصه order_limit پشتیبانی نمی‌شود.
shippingServiceNames[] (پشتیبانی نمی‌شود) shippingServiceNames[] پشتیبانی نمی‌شود.
money_budget (پشتیبانی نمی‌شود) money_budget پشتیبانی نمی‌شود.
promotion_destination_ids promotion_destinations 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,
    ]
    }
  ]
}
قبلی
Migrate order tracking signals
بعدی
Migrate conversion sources management