Package google.shopping.merchant.promotions.v1beta

فهرست مطالب

خدمات تبلیغاتی

خدمات مدیریت تبلیغات برای محصولات.

ترفیع گرفتن

rpc GetPromotion( GetPromotionRequest ) returns ( Promotion )

تبلیغ را از حساب Merchant Center شما بازیابی می کند.

پس از درج یا به‌روزرسانی ورودی تبلیغات، ممکن است چند دقیقه طول بکشد تا تبلیغات به‌روز شده بازیابی شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

InsertPromotion

rpc InsertPromotion( InsertPromotionRequest ) returns ( Promotion )

یک تبلیغ برای حساب Merchant Center شما درج می کند. اگر تبلیغات از قبل وجود داشته باشد، در عوض تبلیغ را به روز می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

لیست تبلیغات

rpc ListPromotions( ListPromotionsRequest ) returns ( ListPromotionsResponse )

تبلیغات را در حساب Merchant Center شما فهرست می کند. پاسخ ممکن است حاوی موارد کمتری نسبت به pageSize باشد. برای تعیین اینکه آیا موارد بیشتری برای درخواست وجود دارد یا خیر، به pageToken تکیه کنید.

پس از درج یا به‌روزرسانی یک تبلیغ، ممکن است چند دقیقه طول بکشد تا تبلیغات پردازش شده به‌روز شده بازیابی شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ویژگی های

ویژگی های.

زمینه های
product_applicability

ProductApplicability

ضروری. قابلیت کاربرد تبلیغات برای همه محصولات یا فقط محصولات خاص .

offer_type

OfferType

ضروری. نوع تبلیغ از این ویژگی برای نشان دادن اینکه آیا مشتریان برای بازخرید تبلیغات شما به کد کوپن نیاز دارند یا خیر، استفاده کنید.

generic_redemption_code

string

اختیاری. کد بازخرید عمومی برای تبلیغات. برای استفاده با قسمت offerType و باید حداقل شرایط را برآورده کند.

long_title

string

ضروری. عنوان طولانی برای ارتقاء

coupon_value_type

CouponValueType

ضروری. ویژگی نوع ارزش کوپن برای نشان دادن نوع تبلیغی که در حال اجرا هستید. بسته به نوع ارزش کوپن انتخاب شده ، برخی از ویژگی ها مورد نیاز است .

promotion_destinations[]

DestinationEnum

ضروری. فهرست مقاصدی که تبلیغات برای آنها اعمال می شود. اگر مقصدی را با گنجاندن مقدار پشتیبانی شده در منبع داده خود مشخص نکنید، تبلیغ شما به طور پیش‌فرض در آگهی‌های خرید و فهرست‌های رایگان نمایش داده می‌شود.

ممکن است قبلاً مقادیر زیر را به عنوان مقصد محصولات خود ارسال کرده باشید: اقدامات خرید، سطوح در سراسر Google، سطوح محلی در سراسر Google. برای نمایش این مقادیر از FREE_LISTINGS ، FREE_LOCAL_LISTINGS ، LOCAL_INVENTORY_ADS استفاده کنید. برای جزئیات بیشتر به مقصد تبلیغاتی مراجعه کنید

item_id_inclusion[]

string

اختیاری. فیلتر محصول بر اساس شناسه مورد برای تبلیغات. ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای ارتقاء، قابلیت کاربردی بودن محصول، ویژگی product_applicability روی specific_products تنظیم شده باشد.

brand_inclusion[]

string

اختیاری. فیلتر محصول بر اساس برند برای تبلیغات. ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای ارتقاء، قابلیت کاربردی بودن محصول، ویژگی product_applicability روی specific_products تنظیم شده باشد.

item_group_id_inclusion[]

string

اختیاری. فیلتر محصول بر اساس شناسه گروه مورد برای تبلیغات. ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای کاربردی بودن محصول تبلیغاتی [محصول_کاربردی] روی specific_products تنظیم شده باشد.

product_type_inclusion[]

string

اختیاری. فیلتر محصول بر اساس نوع محصول برای تبلیغات. ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای ارتقاء، قابلیت کاربرد محصول، ویژگی product_applicability ، روی specific_products تنظیم شده باشد.

item_id_exclusion[]

string

اختیاری. فیلتر محصول بر اساس حذف شناسه مورد برای تبلیغات. ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای ارتقاء، قابلیت کاربردی بودن محصول، ویژگی product_applicability روی specific_products تنظیم شده باشد.

brand_exclusion[]

string

اختیاری. فیلتر محصول بر اساس حذف نام تجاری برای تبلیغ. ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای ارتقاء، قابلیت کاربردی بودن محصول، ویژگی product_applicability روی specific_products تنظیم شده باشد.

item_group_id_exclusion[]

string

اختیاری. فیلتر محصول بر اساس شناسه گروه مورد . ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای ارتقاء، قابلیت کاربرد محصول، ویژگی product_applicability ، روی specific_products تنظیم شده باشد. محرومیت برای ارتقاء

product_type_exclusion[]

string

اختیاری. فیلتر محصول بر اساس نوع محصول استثنا برای تبلیغات. ویژگی‌های فیلتر محصول فقط زمانی اعمال می‌شود که محصولات واجد شرایط برای ارتقاء، قابلیت کاربرد محصول، ویژگی product_applicability ، روی specific_products تنظیم شده باشد.

minimum_purchase_amount

Price

اختیاری. حداقل مبلغ خرید برای تبلیغات.

minimum_purchase_quantity

int64

اختیاری. حداقل مقدار خرید برای تبلیغات.

limit_quantity

int64

اختیاری. حداکثر مقدار خرید برای تبلیغات.

limit_value

Price

اختیاری. حداکثر قیمت محصول برای تبلیغ.

percent_off

int64

اختیاری. درصد تخفیف ارائه شده در تبلیغات.

money_off_amount

Price

اختیاری. مقدار پولی که در تبلیغات ارائه شده است.

get_this_quantity_discounted

int64

اختیاری. تعداد کالاهایی که در تبلیغات تخفیف داده شده است. این ویژگی زمانی تنظیم می شود که couponValueType برابر با buy_m_get_n_money_off یا buy_m_get_n_percent_off باشد.

free_gift_value

Price

اختیاری. ارزش هدیه رایگان برای تبلیغات.

free_gift_description

string

اختیاری. توضیحات هدیه رایگان برای تبلیغات.

free_gift_item_id

string

اختیاری. شناسه کالای هدیه رایگان برای تبلیغات.

promotion_effective_time_period

Interval

ضروری. نمایش TimePeriod از تاریخ های موثر تبلیغات. این ویژگی مشخص می‌کند که تبلیغات را می‌توان در فروشگاه آنلاین شما در این بازه زمانی آزمایش کرد.

promotion_display_time_period

Interval

اختیاری. نمایش TimePeriod تاریخ های نمایش تبلیغات. این مشخصه تاریخ و بازه زمانی را مشخص می‌کند که تبلیغات در Google.com و تبلیغات خرید فعال می‌شود. اگر بازه زمانی نمایش برای ویژگی promotion_display_time_period مشخص نشده باشد، بازه زمانی مؤثر تبلیغاتی promotion_effective_time_period تاریخ و چارچوب زمانی را که تبلیغات در Google.com و تبلیغات خرید به صورت زنده اجرا می‌شود، تعیین می‌کند.

store_applicability

StoreApplicability

اختیاری. آیا این تبلیغات برای همه فروشگاه‌ها اعمال می‌شود یا فقط فروشگاه‌های مشخص شده . تبلیغات موجودی محلی در صورت عدم استفاده از فروشگاه با خطا مواجه می شوند. اگر store_applicability روی ALL_STORES تنظیم شود و store_codes_inclusion یا score_code_exclusion روی یک مقدار تنظیم شود، خطای INVALID_ARGUMENT ایجاد می‌شود.

store_codes_inclusion[]

string

اختیاری. کدهای فروشگاهی که باید برای تبلیغات درج شوند . ویژگی‌های فیلتر فروشگاه فقط زمانی اعمال می‌شود که ویژگی store_applicability روی specific_stores تنظیم شده باشد.

کد فروشگاه (شناسه فروشگاه از نمایه کسب‌وکار شما) فروشگاه فیزیکی که محصول در آن فروخته می‌شود. برای اطلاعات بیشتر به مشخصات داده‌های موجودی محصول محلی مراجعه کنید.

store_codes_exclusion[]

string

اختیاری. کدهای فروشگاه برای حذف برای تبلیغات. ویژگی‌های فیلتر فروشگاه فقط زمانی اعمال می‌شود که ویژگی store_applicability روی specific_stores تنظیم شده باشد.

promotion_url

string

اختیاری. نشانی وب صفحه در سایت تاجر که در آن تبلیغ نمایش داده می شود. اگر promotion_url نباشد، تبلیغات موجودی محلی با خطا مواجه می‌شوند. از نشانی وب برای تأیید معتبر بودن تبلیغ و قابل بازخرید استفاده می شود.

CouponValueType

نوع ارزش کوپن یک تبلیغ.

Enums
COUPON_VALUE_TYPE_UNSPECIFIED نشان می دهد که نوع ارزش کوپن مشخص نشده است.
MONEY_OFF نوع ارزش کوپن پول تخفیف.
PERCENT_OFF نوع ارزش کوپن درصد تخفیف.
BUY_M_GET_N_MONEY_OFF مقدار M بخرید، از نوع ارزش کوپن N پول دریافت کنید. minimum_purchase_quantity و get_this_quantity_discounted باید وجود داشته باشد. money_off_amount نیز باید وجود داشته باشد.
BUY_M_GET_N_PERCENT_OFF مقدار M را خریداری کنید، از نوع ارزش کوپن N درصد تخفیف دریافت کنید. minimum_purchase_quantity و get_this_quantity_discounted باید وجود داشته باشد. percent_off_percentage نیز باید وجود داشته باشد.
BUY_M_GET_MONEY_OFF مقدار M بخرید، پول بگیرید. minimum_purchase_quantity و money_off_amount باید وجود داشته باشد.
BUY_M_GET_PERCENT_OFF مقدار M بخرید، پول بگیرید. minimum_purchase_quantity و percent_off_percentage باید وجود داشته باشد.
FREE_GIFT هدیه رایگان فقط با توضیحات.
FREE_GIFT_WITH_VALUE هدیه رایگان با ارزش پولی.
FREE_GIFT_WITH_ITEM_ID هدیه رایگان با شناسه کالا.
FREE_SHIPPING_STANDARD نوع ارزش کوپن حمل و نقل رایگان استاندارد.
FREE_SHIPPING_OVERNIGHT نوع ارزش کوپن ارسال رایگان شبانه.
FREE_SHIPPING_TWO_DAY نوع ارزش کوپن ارسال رایگان دو روزه.

GetPromotionRequest

درخواست پیام برای روش GetPromotion .

زمینه های
name

string

ضروری. نام تبلیغی که باید بازیابی شود. قالب: accounts/{account}/promotions/{promotions}

InsertPromotionRequest

درخواست پیام برای روش InsertPromotion .

زمینه های
parent

string

ضروری. حسابی که تبلیغ در آن درج خواهد شد. قالب: حساب‌ها/{حساب}

promotion

Promotion

ضروری. تبلیغ برای درج.

data_source

string

ضروری. منبع داده تبلیغ قالب: accounts/{account}/dataSources/{datasource} .

ListPromotionsRequest

درخواست پیام برای روش ListPromotions .

زمینه های
parent

string

ضروری. حسابی برای فهرست تبلیغات پردازش شده. قالب: accounts/{account}

page_size

int32

فقط خروجی حداکثر تعداد تبلیغات برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود. اگر مشخص نشده باشد، حداکثر تعداد تبلیغات برگردانده می شود.

page_token

string

فقط خروجی یک نشانه صفحه، دریافت شده از تماس قبلی ListPromotions . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListPromotions باید با تماسی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListPromotionsResponse

پیام پاسخ برای روش ListPromotions .

زمینه های
promotions[]

Promotion

تبلیغات پردازش شده از حساب مشخص شده.

next_page_token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

OfferType

نوع پیشنهاد یک ترفیع

Enums
OFFER_TYPE_UNSPECIFIED نوع پیشنهاد نامشخص.
NO_CODE نوع پیشنهاد بدون کد
GENERIC_CODE نوع پیشنهاد با کد زمانی که offerType = GENERIC_CODE کد بازخرید عمومی برای تبلیغ مورد نیاز است.

کاربرد محصول

تبلیغ برای کدام محصول یا لیست محصولات اعمال می شود.

Enums
PRODUCT_APPLICABILITY_UNSPECIFIED این تبلیغات برای کدام محصولات اعمال می شود، ناشناخته است.
ALL_PRODUCTS قابل اجرا برای تمامی محصولات
SPECIFIC_PRODUCTS فقط برای یک محصول یا لیستی از محصولات قابل استفاده است.

ترویج

نشان دهنده یک ترفیع است. برای جزئیات بیشتر به مقالات زیر مراجعه کنید.

ویژگی‌های ورودی تبلیغاتی مورد نیاز برای گذراندن بررسی‌های اعتبارسنجی داده‌ها عمدتاً در زیر تعریف می‌شوند:

پس از درج، به‌روزرسانی ورودی تبلیغات، ممکن است چند دقیقه طول بکشد تا تبلیغات نهایی بازیابی شود.

زمینه های
name

string

مشخص کننده. نام تبلیغ. قالب: accounts/{account}/promotions/{promotion}

promotion_id

string

ضروری. کاربر شناسه تبلیغاتی را برای شناسایی منحصر به فرد تبلیغ ارائه کرده است. برای جلوگیری از عدم تایید تبلیغات ، حداقل الزامات را دنبال کنید.

content_language

string

ضروری. کد زبان دو حرفی ISO 639-1 برای تبلیغ.

تبلیغات فقط برای زبان های انتخاب شده است.

target_country

string

ضروری. کشور هدف که به عنوان بخشی از شناسه منحصر به فرد استفاده می شود. به عنوان کد قلمرو CLDR نشان داده شده است.

تبلیغات فقط در کشورهای منتخب، فهرست‌های رایگان و آگهی‌های خرید، آگهی‌های موجودی محلی موجود است

redemption_channel[]

RedemptionChannel

ضروری. کانال بازخرید برای تبلیغات. حداقل یک کانال مورد نیاز است.

data_source

string

فقط خروجی منبع داده اولیه تبلیغات.

attributes

Attributes

اختیاری. لیستی از ویژگی های ارتقاء

custom_attributes[]

CustomAttribute

اختیاری. فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان). همچنین می‌توان از آن برای ارسال هر ویژگی از مشخصات داده‌ها به شکل عمومی آن استفاده کرد (به عنوان مثال، { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به صراحت توسط API نشان داده نشده‌اند مفید است.

promotion_status

PromotionStatus

فقط خروجی وضعیت یک تبلیغ ، مسائل مربوط به اعتبار سنجی داده ها، یعنی اطلاعات مربوط به یک تبلیغ به صورت ناهمزمان محاسبه شده است.

version_number

int64

اختیاری. نشان دهنده نسخه موجود (تازه بودن) تبلیغات است که می تواند برای حفظ نظم درست زمانی که به روز رسانی های متعدد به طور همزمان انجام می شود استفاده شود.

در صورت تنظیم، زمانی که شماره نسخه کمتر از شماره نسخه فعلی تبلیغ موجود باشد، از درج جلوگیری می شود. درج مجدد (به عنوان مثال، بازخوانی تبلیغات پس از 30 روز) را می توان با version_number فعلی انجام داد.

اگر از عمل جلوگیری شود، استثناء سقط شده پرتاب می شود.

وضعیت ارتقاء

وضعیت ارتقاء.

زمینه های
destination_statuses[]

DestinationStatus

فقط خروجی مقاصد مورد نظر برای تبلیغ

item_level_issues[]

ItemLevelIssue

فقط خروجی فهرستی از مسائل مرتبط با تبلیغات.

creation_date

Timestamp

فقط خروجی تاریخی که تبلیغات در قالب ISO 8601 ایجاد شده است: تاریخ، زمان و افست، به عنوان مثال 2020-01-02T09:00:00+01:00 یا 2020-01-02T09:00:00Z

last_update_date

Timestamp

فقط خروجی تاریخی که آخرین بار وضعیت تبلیغ در قالب ISO 8601 به روز شده است: تاریخ، زمان و افست، به عنوان مثال 2020-01-02T09:00:00+01:00 یا 2020-01-02T09:00:00Z

وضعیت مقصد

وضعیت برای مقصد مشخص شده

زمینه های
reporting_context

ReportingContextEnum

فقط خروجی نام مقصد تبلیغاتی

status

State

فقط خروجی وضعیت برای مقصد مشخص شده

حالت

وضعیت فعلی تبلیغ.

Enums
STATE_UNSPECIFIED وضعیت تبلیغ نامشخص
IN_REVIEW تبلیغات در دست بررسی است.
REJECTED تبلیغ تایید نشده است.
LIVE تبلیغات تایید شده و فعال است.
STOPPED تبلیغ توسط تاجر متوقف شده است.
EXPIRED تبلیغات دیگر فعال نیست.
PENDING تبلیغات متوقف نمی شود و همه بررسی ها تأیید می شوند، اما تاریخ فعال در آینده است.

ItemLevelIssue

موضوع مرتبط با ارتقاء

زمینه های
code

string

فقط خروجی کد خطای مشکل

severity

Severity

فقط خروجی چگونه این موضوع بر ارائه تبلیغات تأثیر می گذارد.

resolution

string

فقط خروجی آیا این موضوع می تواند توسط تاجر حل شود یا خیر.

attribute

string

فقط خروجی نام ویژگی، در صورتی که مشکل ناشی از یک ویژگی واحد باشد.

reporting_context

ReportingContextEnum

فقط خروجی مقصدی که موضوع برای آن اعمال می شود.

description

string

فقط خروجی شرح مختصر موضوع به زبان انگلیسی.

detail

string

فقط خروجی شرح مفصل موضوع به زبان انگلیسی.

documentation

string

فقط خروجی URL یک صفحه وب برای کمک به حل این مشکل.

applicable_countries[]

string

فقط خروجی فهرست کدهای کشور (ISO 3166-1 alpha-2) که در آن مشکل برای پیشنهاد اعمال می شود.

شدت

شدت موضوع.

Enums
SEVERITY_UNSPECIFIED مشخص نشده است.
NOT_IMPACTED این موضوع یک هشدار است و تأثیر مستقیمی بر تبلیغات ندارد.
DEMOTED ترفیع کاهش یافته و به احتمال زیاد عملکرد محدودی در نتایج جستجو دارد
DISAPPROVED موضوع تبلیغ را تأیید نمی کند.

RedemptionChannel

کانال یک تبلیغ

Enums
REDEMPTION_CHANNEL_UNSPECIFIED نشان می دهد که کانال نامشخص است.
IN_STORE نشان می دهد که کانال در فروشگاه است. این همان کانال local است که برای products استفاده می شود.
ONLINE نشان دهنده آنلاین بودن کانال است.

StoreApplicability

کدهای فروشگاه یا فهرست کدهای فروشگاهی که تبلیغات برای آنها اعمال می شود. فقط برای تبلیغات موجودی محلی.

Enums
STORE_APPLICABILITY_UNSPECIFIED کدهای فروشگاهی که تبلیغات برای آنها اعمال می شود ناشناخته است.
ALL_STORES تبلیغات برای همه فروشگاه ها اعمال می شود.
SPECIFIC_STORES تبلیغات فقط برای فروشگاه های مشخص شده اعمال می شود.