প্রচার সাব-এপিআই-এর ওভারভিউ,প্রমোশন সাব-এপিআই-এর ওভারভিউ

Google-এ বিক্রি করা পণ্যের জন্য বিশেষ অফার প্রদর্শনের জন্য প্রচারগুলি ব্যবহার করুন। Google Search, Shopping এবং Chrome সহ বিভিন্ন Google সম্পত্তিতে প্রচারগুলি প্রদর্শিত হয়। অনুমোদনের জন্য প্রচারগুলিকে নির্দিষ্ট মানদণ্ড পূরণ করতে হবে। আরও তথ্যের জন্য, প্রচারের মানদণ্ড দেখুন।

যখন আপনি আপনার পণ্যে একটি প্রচারণা যোগ করেন, তখন ক্রেতারা একটি বিশেষ অফারের লিঙ্ক দেখতে পান। উদাহরণস্বরূপ, "১৫% ছাড়" অথবা "বিনামূল্যে শিপিং"। অফারের লিঙ্কগুলি আপনার পণ্যের আকর্ষণ বাড়াতে পারে এবং ক্রেতাদের কেনাকাটা করতে উৎসাহিত করতে পারে। সমস্ত প্রচার চেকআউট বা বিক্রয় কেন্দ্রে প্রয়োগ করা হয়।

আরও তথ্যের জন্য, প্রচারের মূল বিষয়গুলি দেখুন।

পূর্বশর্ত

আপনার প্রচারগুলি প্রদর্শনের আগে Google আপনাকে আপনার ব্যবসা এবং পণ্য সম্পর্কে নির্দিষ্ট তথ্য প্রদান করতে চায়। আপনার অবশ্যই নিম্নলিখিতগুলি থাকতে হবে:

এছাড়াও, আপনাকে অবশ্যই আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টটি প্রচার প্রোগ্রামে নথিভুক্ত করতে হবে। যদি আপনি নিশ্চিত না হন যে আপনি ইতিমধ্যেই নথিভুক্ত কিনা, তাহলে মার্চেন্ট সেন্টারটি দেখুন।

যদি আপনি নথিভুক্ত না হন, তাহলে অনুরোধ ফর্মটি পূরণ করুন। আপনি কখন বাস্তবায়ন শুরু করতে প্রস্তুত তা প্রচার দল আপনাকে জানাবে।

আরও তথ্যের জন্য, অংশগ্রহণের মানদণ্ড এবং নীতি দেখুন।

একটি ডেটা সোর্স তৈরি করুন

আপনি accounts.dataSources.create পদ্ধতি ব্যবহার করে একটি প্রচারমূলক ডেটা উৎস তৈরি করতে পারেন। যদি একটি বিদ্যমান প্রচারমূলক ডেটা উৎস উপলব্ধ থাকে, তাহলে সমস্ত ডেটা উৎস পুনরুদ্ধার করতে accounts.dataSources.list পদ্ধতি ব্যবহার করুন। তারপর আপনি প্রচারমূলক ডেটা উৎসের name ক্ষেত্র ব্যবহার করে প্রচারমূলক ডেটা উৎস তৈরি করতে পারেন।

নিম্নলিখিত অনুরোধটি দেখায় যে কীভাবে প্রচার যোগ করার জন্য একটি ডেটা উৎস তৈরি করতে হয়:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "promotionDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "targetCountry": "{TARGET_COUNTRY}"
  }
}

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

  • {ACCOUNT_ID} : মার্চেন্ট সেন্টার UI-তে প্রদর্শিত আপনার অ্যাকাউন্টের অনন্য শনাক্তকারী।
  • {DISPLAY_NAME} : ডেটা উৎসের প্রদর্শন নাম।
  • {CONTENT_LANGUAGE} : ডেটা সোর্সে থাকা পণ্যগুলির দুই অক্ষরের ISO 639-1 ভাষা কোড।
  • {TARGET_COUNTRY} : আপনি যে দেশের প্রচারগুলি দেখতে চান সেই দেশের CLDR অঞ্চল কোড।

অনুরোধটি সফলভাবে সম্পন্ন হওয়ার পরে, আপনি নিম্নলিখিত প্রতিক্রিয়াটি দেখতে পাবেন যাতে নতুন তৈরি প্রচারের ডেটা উৎস সম্পর্কে বিশদ বিবরণ রয়েছে:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "promotionDataSource": {
    "targetCountry": "{TARGET_COUNTRY}",
    "contentLanguage": "{CONTENT_LANGUAGE}"
  },
  "input": "API"
}

প্রচার তৈরি করুন

আপনি একটি প্রচার তৈরি বা আপডেট করার জন্য accounts.promotions.insert পদ্ধতি ব্যবহার করতে পারেন। accounts.promotions.insert পদ্ধতিতে একটি promotions রিসোর্স এবং একটি ডেটা সোর্সের নাম ইনপুট হিসেবে ব্যবহৃত হয়। সফল হলে এটি নতুন বা আপডেট করা প্রচারটি ফেরত পাঠায়।

একটি প্রচার তৈরি করতে ডেটা উৎসের নাম প্রয়োজন। আপনার অনুরোধে নিম্নলিখিত ক্ষেত্রগুলির জন্য মানও প্রদান করতে হবে:

  • contentLanguage
  • redemptionChannel
  • promotionId
  • targetCountry
  • attributes.offerType
  • attributes.genericRedemptionCode
  • attributes.couponValueType
  • attributes.productApplicability
  • attributes.promotionEffectiveTimePeriod.endTime
  • attributes.promotionEffectiveTimePeriod.startTime
  • attributes.longTitle

Google আপনার প্রচারগুলি বিতরণ করার আগে পর্যালোচনা করে এবং অনুমোদন করে। আরও তথ্যের জন্য, প্রচার অনুমোদন প্রক্রিয়া দেখুন।

আপনার তৈরি করা প্রচারগুলি যাতে মূল্য বৃদ্ধি করে এবং শপিং বিজ্ঞাপন নীতি মেনে চলে তা নিশ্চিত করার জন্য আমরা আপনাকে প্রচার নীতিগুলি পড়ার পরামর্শ দিচ্ছি।

নিম্নলিখিত অনুরোধটি দেখায় কিভাবে একটি অনলাইন প্রচার তৈরি করতে হয়:

HTTP সম্পর্কে 

POST https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert

{
"promotion": {
  "name": "{PROMOTION_NAME}",
  "promotionId": "{PROMOTION_ID}",
  "targetCountry": "{TARGET_COUNTRY}",
  "redemptionChannel": [
    "ONLINE"
  ],
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "attributes": {
    "promotionDisplayTimePeriod": {
      "endTime": "{PROMOTION_END_TIME}",
      "startTime": "{PROMOTION_START_TIME}"
    },
    "offerType": "{OFFER_TYPE}",
    "longTitle": "{LONG_TITLE}"
  }
},
"dataSource": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}"
}

সিআরএল 

  curl --request POST \
'https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"dataSource":"{DATASOURCE_ID}","promotion":{"name":"accounts/{ACCOUNT_ID}/promotions/{PROMOTION_ID}y","promotionId":"abc","contentLanguage":"en","targetCountry":"US","redemptionChannel":["ONLINE"]}}' \
--compressed

আপনার প্রচার আইডি সেট করার ক্ষেত্রে প্রযোজ্য নিয়ম সম্পর্কে তথ্যের জন্য, প্রচার আইডি বৈশিষ্ট্যের জন্য ন্যূনতম প্রয়োজনীয়তা দেখুন।

বাধ্যতামূলক offerType ক্ষেত্রের জন্য বৈধ মানগুলি হল NO_CODE এবং GENERIC_CODE । যদি আপনি এই মানগুলির মধ্যে একটি প্রদান না করেন, তাহলে API অনুরোধটি HTTP 400 প্রতিক্রিয়া [offer_type] validation/missing_required: Invalid or missing required attribute: offer_type সহ ব্যর্থ হবে। যদি আপনি বাধ্যতামূলক ক্ষেত্রগুলির কোনও প্রদান না করেন তবে একই ধরণের ত্রুটি বার্তা ফিরে আসবে।

যদি আপনি attributes.genericRedemptionCode ক্ষেত্রের জন্য একটি মান প্রদান না করেন, তাহলে HTTP 400 প্রতিক্রিয়া [genericRedemptionCode] No redemption code provided ।

promotion.attributes.promotionDisplayTimePeriod.startTime এবং promotion.attributes.promotionDisplayTimePeriod.endTime ফিল্ডের মানগুলি yyyy-mm-ddThh:mm:ssZ ফর্ম্যাটে হতে হবে। এই ফিল্ডগুলির মানগুলি ভবিষ্যতের তারিখ দিয়ে প্রতিস্থাপন করতে ভুলবেন না।

আরও তথ্যের জন্য, প্রচারের ডেটা স্পেসিফিকেশন দেখুন।

প্রচার তৈরির সর্বোত্তম অনুশীলনের জন্য, প্রচারের সর্বোত্তম অনুশীলন দেখুন।

প্রচার-সম্পর্কিত বৈশিষ্ট্যের তালিকার জন্য, স্ট্রাকচার্ড ডেটা বৈশিষ্ট্য যোগ করুন দেখুন।

প্রোমোশন তৈরির অনুরোধ সফলভাবে সম্পন্ন হওয়ার পরে, API ব্যবহার করে প্রোমোশনটি পুনরুদ্ধার করা যেতে বা মার্চেন্ট সেন্টারে প্রদর্শিত হতে কয়েক মিনিট সময় লাগতে পারে।

এখানে একটি নমুনা দেওয়া হল যা আপনি একাধিক প্রচার অ্যাসিঙ্ক্রোনাসভাবে সন্নিবেশ করতে ব্যবহার করতে পারেন:

জাভা 

import com.google.api.core.ApiFuture;
import com.google.api.core.ApiFutureCallback;
import com.google.api.core.ApiFutures;
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.common.util.concurrent.MoreExecutors;
import com.google.protobuf.Timestamp;
import com.google.shopping.merchant.promotions.v1.Attributes;
import com.google.shopping.merchant.promotions.v1.CouponValueType;
import com.google.shopping.merchant.promotions.v1.InsertPromotionRequest;
import com.google.shopping.merchant.promotions.v1.OfferType;
import com.google.shopping.merchant.promotions.v1.ProductApplicability;
import com.google.shopping.merchant.promotions.v1.Promotion;
import com.google.shopping.merchant.promotions.v1.PromotionsServiceClient;
import com.google.shopping.merchant.promotions.v1.PromotionsServiceSettings;
import com.google.shopping.merchant.promotions.v1.RedemptionChannel;
import com.google.shopping.type.CustomAttribute;
import com.google.shopping.type.Destination.DestinationEnum;
import com.google.type.Interval;
import java.util.ArrayList;
import java.util.List;
import java.util.Random;
import java.util.stream.Collectors;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to insert multiple promotions asynchronously. */
public class InsertPromotionsAsyncSample {

  private static String generateRandomString() {
    String characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
    Random random = new Random();
    StringBuilder sb = new StringBuilder(8);
    for (int i = 0; i < 8; i++) {
      sb.append(characters.charAt(random.nextInt(characters.length())));
    }
    return sb.toString();
  }

  private static Promotion createPromotion(String accountId) {
    String merchantPromotionId = generateRandomString();

    Attributes attributes =
        Attributes.newBuilder()
            .setProductApplicability(ProductApplicability.ALL_PRODUCTS)
            .setOfferType(OfferType.GENERIC_CODE)
            .setGenericRedemptionCode("ABCD1234")
            .setLongTitle("My promotion")
            .setCouponValueType(CouponValueType.PERCENT_OFF)
            .addPromotionDestinations(DestinationEnum.SHOPPING_ADS)
            .setPercentOff(10)
            // Note that promotions have a 6-month limit.
            // For more information, read here: https://support.google.com/merchants/answer/2906014
            // Also note that only promotions valid within the past 365 days are shown in the UI.
            .setPromotionEffectiveTimePeriod(
                Interval.newBuilder()
                    .setStartTime(Timestamp.newBuilder().setSeconds(1726842472))
                    .setEndTime(Timestamp.newBuilder().setSeconds(1726842473))
                    .build())
            .build();

    return Promotion.newBuilder()
        .setName(String.format("accounts/%s/merchantPromotions/%s", accountId, merchantPromotionId))
        .setPromotionId(merchantPromotionId)
        .setContentLanguage("fr")
        .setTargetCountry("CH")
        .addRedemptionChannel(RedemptionChannel.ONLINE)
        .setAttributes(attributes)
        // Custom attributes allow you to add additional information which is not available in
        // Attributes. For example, you might want to pilot experimental functionality.
        .addCustomAttributes(
            CustomAttribute.newBuilder()
                .setName("another example name")
                .setValue("another example value")
                .build())
        .build();
  }

  public static void asyncInsertPromotions(String accountId, String dataSourceId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    PromotionsServiceSettings merchantPromotionsServiceSettings =
        PromotionsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (PromotionsServiceClient merchantPromotionsServiceClient =
        PromotionsServiceClient.create(merchantPromotionsServiceSettings)) {

      // Arbitrarily creates five merchant promotions with random IDs.
      List<InsertPromotionRequest> requests = new ArrayList<>();
      for (int i = 0; i < 5; i++) {
        InsertPromotionRequest request =
            InsertPromotionRequest.newBuilder()
                .setParent(String.format("accounts/%s", accountId))
                .setPromotion(createPromotion(accountId))
                .setDataSource(String.format("accounts/%s/dataSources/%s", accountId, dataSourceId))
                .build();
        requests.add(request);
      }

      // Inserts the merchant promotions.
      List<ApiFuture<Promotion>> futures =
          requests.stream()
              .map(
                  request ->
                      merchantPromotionsServiceClient.insertPromotionCallable().futureCall(request))
              .collect(Collectors.toList());

      // Creates callback to handle the responses when all are ready.
      ApiFuture<List<Promotion>> responses = ApiFutures.allAsList(futures);
      ApiFutures.addCallback(
          responses,
          new ApiFutureCallback<List<Promotion>>() {
            @Override
            public void onSuccess(List<Promotion> results) {
              System.out.println("Inserted merchant promotions below:");
              System.out.println(results);
            }

            @Override
            public void onFailure(Throwable throwable) {
              System.out.println(throwable);
            }
          },
          MoreExecutors.directExecutor());
    } catch (Exception e) {
      System.out.println(e);
    }
  }


  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    asyncInsertPromotions(config.getAccountId().toString(), "<YOUR_DATA_SOURCE_ID>");
  }
}
InsertPromotionsAsyncSample.java

শুরু করার জন্য আপনি যে প্রচারগুলি ব্যবহার করতে পারেন তার কিছু নমুনা নিচে দেওয়া হল।

সমস্ত পণ্য এবং সমস্ত দোকানের জন্য প্রযোজ্য একটি স্থানীয় প্রচারণা

নিম্নলিখিত নমুনা অনুরোধটি দেখায় যে কীভাবে আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের সমস্ত পণ্য এবং আপনার লিঙ্ক করা ব্যবসায়িক প্রোফাইল অ্যাকাউন্টে যোগ করা সমস্ত স্টোরের জন্য প্রযোজ্য একটি স্থানীয় প্রচার তৈরি করবেন।

POST https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert

{
  "promotion": {
    "promotionId": "buy_2_get_10_off",
    "contentLanguage": "en",
    "targetCountry": "US",
    "redemptionChannel": [
      "IN_STORE"
    ],
    "attributes": {
      "longTitle": "Buy 2 and get 10$ OFF purchase",
      "productApplicability": "ALL_PRODUCTS",
      "offerType": "NO_CODE",
      "couponValueType": "BUY_M_GET_MONEY_OFF",
      "promotionDisplayTimePeriod": {
        "startTime": "2024-2-06T00:47:44Z",
        "endTime": "2024-5-06T00:47:44Z"
      },
      "promotionEffectiveTimePeriod": {
        "startTime": "2024-2-06T00:47:44Z",
        "endTime": "2024-5-06T00:47:44Z"
      },
      "moneyOffAmount": {
        "amountMicros": "1000000",
        "currencyCode": "USD"
      },
      "minimumPurchaseQuantity": 2,
      "storeApplicability": "ALL_STORES",
      "promotionUrl": "http://promotionnew4url.com/",
      "promotionDestinations": [
        "LOCAL_INVENTORY_ADS"
      ],
    }
  },
  "dataSource": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}"
}

productApplicability ক্ষেত্রটি আবশ্যক। এটি সমস্ত পণ্যের জন্য অথবা শুধুমাত্র নির্দিষ্ট পণ্যের জন্য প্রচারের প্রযোজ্যতার ইঙ্গিত দেয়। সমর্থিত মানগুলি হল ALL_PRODUCTS এবং SPECIFIC_PRODUCTS । আরও তথ্যের জন্য, আপনার প্রচারের জন্য পণ্য নির্বাচন করুন দেখুন।

couponValueType ক্ষেত্রটি আবশ্যক। এটি আপনার চলমান প্রচারের ধরণ নির্দেশ করে। সহায়তা মানের তালিকার জন্য, Coupon value type দেখুন। আপনার নির্বাচিত কুপন মানের ধরণের উপর নির্ভর করে, কিছু বৈশিষ্ট্য প্রয়োজন ।

minimumPurchaseQuantity ফিল্ড আপনাকে প্রোমোশন অফারটি রিডিম করার জন্য প্রয়োজনীয় ন্যূনতম ক্রয়ের পরিমাণের মান সেট করতে দেয়। আরও তথ্যের জন্য, প্রোমোশনের জন্য ন্যূনতম ক্রয়ের পরিমাণ দেখুন।

একইভাবে, আপনি প্রচারটি রিডিম করার জন্য প্রয়োজনীয় ন্যূনতম ক্রয়ের পরিমাণ নির্ধারণ করতে minimumPurchaseAmount ক্ষেত্রটি ব্যবহার করতে পারেন। আরও তথ্যের জন্য, ন্যূনতম ক্রয়ের পরিমাণ দেখুন।

স্থানীয় প্রচার তৈরির জন্য আপনাকে যে মানগুলি প্রদান করতে হবে সে সম্পর্কে আরও তথ্যের জন্য, স্থানীয় প্রচারের জন্য ডেটা সোর্স স্পেসিফিকেশন দেখুন।

রিডেম্পশন কোড সহ নির্বাচিত পণ্যগুলিতে আবেদন করা একটি অনলাইন প্রচারণা

নিম্নলিখিত নমুনা অনুরোধটি দেখায় যে কীভাবে একটি অনলাইন প্রচার তৈরি করতে হয় যা নির্বাচিত পণ্যগুলিতে রিডেম্পশন কোড সহ প্রযোজ্য।

POST https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert

{
 "promotion": {
   "promotionId": "25_pct_off",
   "contentLanguage": "en",
   "targetCountry": "US",
   "redemptionChannel": [
     "ONLINE"
   ],
   "attributes": {
     "longTitle": "10% off on selected items",
     "productApplicability": "SPECIFIC_PRODUCTS",
     "offerType": "GENERIC_CODE",
     "genericRedemptionCode": "SPRINGSALE",
     "couponValueType": "PERCENT_OFF",
     "promotionDisplayTimePeriod": {
       "startTime": "2024-2-06T00:47:44Z",
       "endTime": "2024-5-06T00:47:44Z"
     },
     "promotionEffectiveTimePeriod": {
       "startTime": "2024-2-06T00:47:44Z",
       "endTime": "2024-5-06T00:47:44Z"
     },
     "percentOff": 25,
     "promotionDestinations": [
       "FREE_LISTINGS"
     ],
     "itemIdInclusion": [
       "1499860100",
       "1499860101",
       "1499860102",
       "1499860103",
       "1499860104"
     ],
   }
 },
 "dataSource": "accounts/{ACCOUNT_ID}/dataSources/1000000573361824"
}

প্রচার দেখুন

একটি প্রচার দেখতে, accounts.promotions.get ব্যবহার করুন। এই GET অনুরোধটি কেবল পঠনযোগ্য। এর জন্য আপনার merchantId এবং প্রচারের আইডি প্রয়োজন। GET পদ্ধতিটি সংশ্লিষ্ট প্রচারের রিসোর্স ফেরত দেয়।

উদাহরণস্বরূপ:

HTTP সম্পর্কে 

GET https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/{PROMOTION_ID}

সিআরএল 

  curl \
   'https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/{PROMOTION_ID}?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

  • {ACCOUNT_ID} : আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের অনন্য শনাক্তকারী।
  • {PROMOTION_ID} : আপনি যে প্রচারটি পুনরুদ্ধার করতে চান তার অনন্য শনাক্তকারী। ফর্ম্যাটটি হল {CHANNEL} ~ {CONTENT_LANGUAGE} ~ {TARGET_COUNTRY} ~ {PROMOTION_ID} ।

মনে রাখবেন যে API ব্যবহার করে নতুন তৈরি করা একটি প্রচার পুনরুদ্ধার করতে কয়েক মিনিট সময় লাগে।

স্থানীয় প্রচার দেখুন

নিম্নলিখিত নমুনা অনুরোধটি একটি স্থানীয় প্রচারণা পুনরুদ্ধার করে যার প্রচারণা আইডি হল in_store~en~US~buy_2_get_10_off । 

GET https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/in_store~en~US~buy_2_get_10_off

অনুরোধটি সফল হওয়ার পরে, আপনি নিম্নলিখিত প্রতিক্রিয়াটি দেখতে পাবেন: 

{
 "name": "accounts/{ACCOUNT_ID}/promotions/in_store~en~US~buy_2_get_10_off",
 "promotionId": "buy_2_get_10_off",
 "contentLanguage": "en",
 "targetCountry": "US",
 "redemptionChannel": [
   "IN_STORE"
 ],
 "attributes": {
   "longTitle": "Buy 2 and get 10$ OFF purchase",
   "productApplicability": "ALL_PRODUCTS",
   "offerType": "NO_CODE",
   "couponValueType": "BUY_M_GET_MONEY_OFF",
   "promotionDisplayTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "promotionEffectiveTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "moneyOffAmount": {
     "amountMicros": "1000000",
     "currencyCode": "USD"
   },
   "minimumPurchaseQuantity": 2,
   "storeApplicability": "ALL_STORES",
   "promotionUrl": "http://promotionnew4url.com/",
   "promotionDestinations": [
     "LOCAL_INVENTORY_ADS"
   ],
 }
 "dataSource": "accounts/{ACCOUNT_ID}/dataSources/1000000573361824"
}

এই নমুনার moneyOffAmount ক্ষেত্রটি প্রচারে প্রদত্ত ছাড় প্রদান করে। আরও তথ্যের জন্য, একটি প্রচারের আর্থিক ছাড়ের পরিমাণ দেখুন।

এই নমুনার promotionUrl ফিল্ডটি দোকানের ওয়েবসাইটের লিঙ্ক প্রদান করে যেখানে ক্রেতারা প্রচার সম্পর্কে আরও তথ্য পেতে পারেন। যদি আপনি promotionUrl ফিল্ডটি অন্তর্ভুক্ত না করেন তবে স্থানীয় ইনভেন্টরি বিজ্ঞাপন প্রচারগুলি একটি ত্রুটি ফেরত দেয়।

একটি অনলাইন প্রচার দেখুন

নিম্নলিখিত নমুনা অনুরোধটি এমন একটি অনলাইন প্রচার পুনরুদ্ধার করে যার প্রচার আইডি হল online~en~US~25_pct_off । 

GET https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions/online~en~US~25_pct_off
{
 "name": "accounts/{ACCOUNT_ID}/promotions/online~en~US~25_pct_off",
 "promotionId": "25_pct_off",
 "contentLanguage": "en",
 "targetCountry": "US",
 "redemptionChannel": [
   "ONLINE"
 ],
 "attributes": {
   "longTitle": "10% off on selected items",
   "productApplicability": "SPECIFIC_PRODUCTS",
   "offerType": "GENERIC_CODE",
   "genericRedemptionCode": "WINTERGIFT",
   "couponValueType": "PERCENT_OFF",
   "promotionDisplayTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "promotionEffectiveTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "percentOff": 25,
   "promotionDestinations": [
     "FREE_LISTINGS"
   ],
   "itemIdInclusion": [
     "1499860100",
     "1499860101",
     "1499860102",
     "1499860103",
     "1499860104"
   ],
 }
 "dataSource": "accounts/{ACCOUNT_ID}/dataSources/{dataSource}"
}

এই নমুনায় ব্যবহৃত itemIdInclusion ক্ষেত্রটিতে প্রচারের জন্য যোগ্য পণ্যগুলি উল্লেখ করা হয়েছে। আরও তথ্যের জন্য, প্রচারের জন্য পণ্য আইডি দেখুন।

প্রচারের তালিকা তৈরি করুন

তৈরি করা সমস্ত প্রচার দেখতে আপনি promotions.list পদ্ধতি ব্যবহার করতে পারেন।

এখানে একটি নমুনা অনুরোধ:

HTTP সম্পর্কে 

GET https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_ID}/promotions

সিআরএল 

  curl \
   'https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed

উত্তরে আপনার অ্যাকাউন্টের সমস্ত প্রচারের তালিকা রয়েছে। প্রতিটি প্রচারের জন্য, আপনি promotionId , redemptionChannel , dataSource , promotionStatus এবং আরও অনেক কিছুর মতো বিবরণ দেখতে পাবেন।

একটি প্রচারের অবস্থা দেখুন

কোনও প্রচারের স্ট্যাটাস দেখতে, promotions.get অথবা promotions.list পদ্ধতি দ্বারা প্রদত্ত promotionStatus অ্যাট্রিবিউটটি দেখুন।

promotionStatus ফিল্ডের নিম্নলিখিত মান থাকতে পারে:

  • IN_REVIEW : প্রচারটি এখনও পর্যালোচনাধীন।
  • REJECTED : পদোন্নতিটি অনুমোদিত নয়।
  • LIVE : প্রচারটি অনুমোদিত এবং সক্রিয়।
  • STOPPED : অ্যাকাউন্টটি প্রচার বন্ধ করে দিয়েছে।
  • EXPIRED : প্রচারটি আর সক্রিয় নেই।
  • PENDING : প্রচার বন্ধ করা হয়নি, এবং সমস্ত পর্যালোচনা অনুমোদিত হয়েছে, তবে সক্রিয় তারিখ ভবিষ্যতের।
  • STATE_UNSPECIFIED : প্রচারের অবস্থা অজানা।

আপনার তৈরি করা একটি প্রচারের অনুমোদন প্রক্রিয়াটি বুঝতে, প্রচার অনুমোদন প্রক্রিয়াটি দেখুন।

নমুনা পদোন্নতির অবস্থা

নিম্নলিখিত নমুনাগুলি সফল এবং ব্যর্থ অনুরোধের মধ্যে পার্থক্য প্রদর্শন করে।

পণ্য ম্যাপিং অনুপস্থিত

নিম্নলিখিত প্রতিক্রিয়ার মূল অংশটি এমন একটি অনলাইন প্রচার দেখায় যা পণ্য ম্যাপিং অনুপস্থিত থাকার কারণে অনুমোদিত নয়। 

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "REJECTED"
      }
    ],
    "itemLevelIssues": [
      {
        "code": "promotion_sku_unmapped",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unmapped",
        "detail": "This promotion couldn't be tested during review because it doesn't apply to any products that are currently in your Products feed",
        "documentation": "https://support.google.com/merchants/answer/2906014",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "promotion_sku_additional_requirements",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Promotion conditions not allowed",
        "detail": "This promotion has additional requirements that are not allowed such as requiring customers to verify additional details like phone number or ID before showing the promotion details",
        "documentation": "https://support.google.com/merchants/answer/2906014",
        "applicableCountries": [
          "US"
        ]
      }
    ]
  }

অননুমোদিত প্রচারের সমস্যা সমাধানের জন্য এবং ভবিষ্যতে অননুমোদিত প্রচারের সমস্যাগুলি কীভাবে এড়ানো যায় তা জানতে, অননুমোদিত প্রচারের সমস্যাগুলি সমাধান করুন দেখুন।

যদি আপনার তৈরি করা কোনও প্রচার অনুমোদিত না হয়, তাহলে আপনি প্রত্যাখ্যানের কারণ এবং সমস্যাগুলি সমাধানের নির্দেশাবলী উল্লেখ করে একটি ইমেল পাবেন।

পদোন্নতি মূল্যায়নাধীন

নিম্নলিখিত প্রতিক্রিয়ার মূল অংশটি এমন একটি পদোন্নতি দেখায় যা এখনও মূল্যায়ন করা হচ্ছে। 

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "PENDING"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "PENDING"
      }
    ],
    "itemLevelIssues": []
  }

একটি অনুমোদিত এবং লাইভ প্রচারণা

নিম্নলিখিত প্রতিক্রিয়ার অংশটি এমন একটি প্রচার দেখায় যা ক্রেতারা দেখতে পাবেন। 

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "LIVE"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "LIVE"
 }  ],
    "itemLevelIssues": []
  }

আরও তথ্যের জন্য, প্রচারের অবস্থা সম্পর্কিত প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী দেখুন।

প্রচারগুলি মুছুন

API ব্যবহার করে কোনও প্রচার মুছে ফেলা সম্ভব নয়। কোনও প্রচার মুছে ফেলার জন্য, আপনাকে মার্চেন্ট সেন্টার UI অ্যাক্সেস করতে হবে। আরও তথ্যের জন্য, একটি প্রচার সম্পাদনা করুন বা প্রচারের স্থিতি পরিবর্তন করুন দেখুন।

একটি বিদ্যমান প্রচার শেষ করতে, আপনি accounts.promotions.insert পদ্ধতি ব্যবহার করে attributes.promotionEffectiveTimePeriod.endTime ক্ষেত্রটিকে অতীতের একটি সময়ে আপডেট করতে পারেন।

আরও জানুন