חשוב: אנחנו נוציא משימוש את Content API for Shopping ב-18 באוגוסט 2026.

אם אתם צריכים עוד זמן כדי לעבור ל-Merchant API, אתם יכולים להגיש בקשה להארכת הגישה ל-Content API for Shopping.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

סקירה כללית על ממשק ה-API המשני של מבצעים

אתם יכולים להשתמש במבצעים כדי להציג הטבות מיוחדות על מוצרים שאתם מוכרים ב-Google. המבצעים מוצגים במוצרי Google השונים, כולל חיפוש Google, שופינג ו-Chrome. כדי שהמבצעים יאושרו, הם צריכים לעמוד בקריטריונים מסוימים. מידע נוסף על התכונה "מבצעים"

כשאתם מוסיפים מבצע למוצרים, הקונים רואים קישור למבצע מיוחד. לדוגמה, "15% הנחה" או "משלוח חינם". קישורים למוצרים יכולים להגביר את האטרקטיביות של המוצרים ולעודד את הקונים לקנות. כל המבצעים ממומשים בקופה או בנקודת המכירה.

מידע בסיסי על מבצעים

דרישות מוקדמות

כדי ש-Google תציג את המבצעים שלכם, אתם צריכים לספק מידע ספציפי על העסק ועל המוצרים שלכם. אתם צריכים:

מקור נתוני מוצרים ב-Google Merchant Center.
מקור לנתוני מבצעים ב-Google Merchant Center.
חשבון Google Ads לקמפיינים של שופינג.

בנוסף, אתם צריכים לרשום את חשבון Merchant Center שלכם לתוכנית המבצעים. אם אתם לא בטוחים אם כבר נרשמתם, אתם יכולים לבדוק את זה ב-Merchant Center.

אם אתם לא רשומים, מלאו את טופס הבקשה. צוות המבצעים יודיע לכם כשתהיו מוכנים להתחיל בהטמעה.

מידע נוסף זמין בקריטריונים ומדיניות להשתתפות.

יצירת מקור נתונים

כדי ליצור מקור לנתוני מבצעים, אתם יכולים להשתמש ב-method‏ accounts.dataSources.create. אם יש מקור קיים לנתוני מבצעים, משתמשים ב-method‏ accounts.dataSources.list כדי לאחזר את כל מקורות הנתונים. אחר כך אפשר להשתמש בשדה name של מקור נתוני המבצעים כדי ליצור מבצעים.

כדי להפנות אליהם ישירות בקריאות עתידיות ל-API, מומלץ מאוד לאחסן את accounts.dataSources.name במסד הנתונים המקומי שלכם לכל מבצע. אתם יכולים לבצע מילוי חוסרים חד-פעמי במסד הנתונים המקומי.

הבקשה הבאה מראה איך ליצור מקור נתונים להוספת מבצעים:

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

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

מחליפים את מה שכתוב בשדות הבאים:

‫{ACCOUNT_ID}: המזהה הייחודי של החשבון שלכם, כמו שהוא מופיע בממשק המשתמש של Merchant Center.
‫{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"
}

קידומי מכירות

כדי ליצור או לעדכן מבצע, אתם יכולים להשתמש ב-method‏ 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

  curl --request POST \
'https://merchantapi.googleapis.com/promotions/v1/accounts/{ACCOUNT_ID}/promotions:insert?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer {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 או עד שהוא יופיע ב-Merchant Center.

הנה דוגמה שאפשר להשתמש בה כדי להוסיף כמה מבצעים באופן אסינכרוני:

Java

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.api.gax.grpc.ChannelPoolSettings;
import com.google.api.gax.grpc.InstantiatingGrpcChannelProvider;
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();

    // Creates a channel provider. This provider manages a pool of gRPC channels
    // to enhance throughput for bulk operations. Each individual channel in the pool
    // can handle up to approximately 100 concurrent requests.
    //
    // Channel: A single connection pathway to the service.
    // Pool: A collection of multiple channels managed by this provider.
    //   Requests are distributed across the channels in the pool.
    //
    // We recommend estimating the number of concurrent requests you'll make, divide by 50 (50%
    // utilization of channel capacity), and set the pool size to that number.
    InstantiatingGrpcChannelProvider channelProvider =
        InstantiatingGrpcChannelProvider.newBuilder()
            .setChannelPoolSettings(ChannelPoolSettings.staticallySized(30))
            .build();

    PromotionsServiceSettings merchantPromotionsServiceSettings =
        PromotionsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .setTransportChannelProvider(channelProvider)
            .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

הנה כמה דוגמאות למבצעים שיעזרו לכם להתחיל.

מבצע מקומי שחל על כל המוצרים וכל החנויות

בקשת הדוגמה הבאה מראה איך ליצור מבצע בחנות מקומית שחל על כל המוצרים בחשבון Merchant Center ועל כל החנויות שנוספו לחשבון פרופיל העסק ב-Google המקושר.

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 הוא חובה. הוא מציין את סוג המבצע שאתם מפעילים. רשימת הערכים הנתמכים מופיעה במאמר סוג ערך שובר. בהתאם לסוג ערך השובר שבחרתם, יש מאפיינים שחובה להוסיף.

בשדה 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 ואת המזהה של המבצע. ה-method‏ GET מחזירה את משאב המבצעים המתאים.

לדוגמה:

HTTP

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

cURL

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

מחליפים את מה שכתוב בשדות הבאים:

‫{ACCOUNT_ID}: המזהה הייחודי של חשבון Merchant Center.
‫{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 שבדוגמה הזו מצוינים המוצרים שמשתתפים במבצע. מידע נוסף זמין במאמר מזהה מוצר לקידום.

מבצעים שמוצגים לכולם

אפשר להשתמש ב-method‏ promotions.list כדי לראות את כל המבצעים שנוצרו.

הנה דוגמה לבקשה:

HTTP

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

cURL

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

התשובה מכילה את רשימת כל המבצעים בחשבון שלכם. לכל מבצע אפשר לראות פרטים כמו promotionId, redemptionChannel, dataSource, promotionStatus ועוד.

איך בודקים את הסטטוס של מבצע

כדי לראות את סטטוס המבצע, בודקים את המאפיין promotionStatus שמוחזר על ידי השיטה promotions.get או promotions.list.

השדה 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. כדי למחוק מבצע, צריך להיכנס לממשק המשתמש של Merchant Center. מידע נוסף זמין במאמר עריכת מבצע או שינוי סטטוס מבצע.

כדי לסיים מבצע קיים, אתם יכולים להשתמש ב-method‏ accounts.promotions.insert כדי לעדכן את השדה attributes.promotionEffectiveTimePeriod.endTime לזמן בעבר.

מידע נוסף

פרטים נוספים זמינים במרכז העזרה של מבצעים.
כדי לפתור בעיות נפוצות, אפשר לעיין במאמר פתרון בעיות שקשורות ל-Promotions sub-API.
איך עוברים מ-Content API for Shopping

Troubleshoot issues

סקירה כללית על ממשק ה-API המשני של מבצעים קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

דרישות מוקדמות

יצירת מקור נתונים

קידומי מכירות

HTTP

cURL

Java

מבצע מקומי שחל על כל המוצרים וכל החנויות

מבצע אונליין שחל על מוצרים נבחרים עם קוד מימוש

לצפייה במבצעים

HTTP

cURL

צפייה בקידום של מוצר בחנות מקומית

צפייה במבצע אונליין

מבצעים שמוצגים לכולם

HTTP

cURL

איך בודקים את הסטטוס של מבצע

סטטוס מבצע לדוגמה

מחיקת מבצעים

מידע נוסף

סקירה כללית על ממשק ה-API המשני של מבצעים