অর্ডার ট্র্যাকিং সিগন্যাল আপনাকে একটি বণিকের সাইটের মাধ্যমে সম্পন্ন করা অর্ডারগুলির জন্য আপনার ঐতিহাসিক অর্ডার ট্র্যাকিং ডেটা Google-কে প্রদান করতে দেয়। এটি ক্রেতাদের আরো সুনির্দিষ্ট এবং সঠিক শিপিং অনুমান প্রদান করে। অর্ডার ট্র্যাকিং সংকেতগুলি আপনাকে বিনামূল্যে এবং দ্রুত শিপিং টীকাগুলির সাথে আপনার তালিকাগুলিকে উন্নত করতে দেয়৷
আপনি একজন বণিকের সাইটের মাধ্যমে সম্পন্ন অর্ডারের জন্য ডেটা জমা দিতে পারেন। আপনার জমা দেওয়া ডেটা শিপিং কনফিগারেশন তথ্যের প্রশংসা করে যা আপনি আপনার Merchant Center অ্যাকাউন্ট সেটআপের অংশ হিসেবে প্রদান করেন। উদাহরণস্বরূপ, আপনি যদি ক্রেতাদের 3-7 দিনের শিপিংয়ের অনুমান সরবরাহ করেন, কিন্তু আপনার সাম্প্রতিক ঐতিহাসিক অর্ডার ট্র্যাকিং নির্দেশ করে যে আপনার অর্ডারগুলি সাধারণত 3 দিনের মধ্যে কিছু অঞ্চলে পৌঁছায়, Google গ্রাহকদের আরও সুনির্দিষ্ট অনুমান প্রদান করতে আপনার তালিকা আপডেট করতে পারে।
আপনার ঐতিহাসিক অর্ডার ট্র্যাকিং ডেটা জমা দেওয়ার জন্য ordertrackingsignals সংস্থান কীভাবে ব্যবহার করবেন তা এই নির্দেশিকা ব্যাখ্যা করে।
পূর্বশর্ত
অন্য অ্যাকাউন্টের জন্য অর্ডার ট্র্যাকিং সংকেত পাঠানোর জন্য আপনার অ্যাকাউন্টটি অবশ্যই আগে থেকে অনুমোদিত হতে হবে, এর জন্য অন্য অ্যাকাউন্টটিকে অ্যাকাউন্টধারকের সাথে লিঙ্ক করতে হবে।
আরও তথ্যের জন্য, আপনার Merchant Center অ্যাকাউন্টের সাথে একজন অংশীদারকে লিঙ্ক করুন দেখুন।
ordertrackingsignals রিসোর্স ব্যবহার করুন
ordertrackingsignals রিসোর্সে একটি একক create এন্ডপয়েন্ট রয়েছে, যা আপনাকে আপনার ঐতিহাসিক অর্ডার ট্র্যাকিং ডেটা জমা দিতে দেয়।
আপনি অনুরোধ প্রতি একটি অর্ডার জমা দিতে পারেন. নিম্নলিখিত তথ্য ব্যাখ্যা করে কেন এটি প্রয়োজন এবং অনুরোধের অংশে যোগ করা যেতে পারে।
অর্ডারের বিশদ বিবরণ (অর্ডার তৈরির সময়, ডেলিভারি পোস্টাল কোড এবং অঞ্চল কোড),
shippingInfo, এবং ট্র্যাকিং নম্বর: এটি প্রকৃত হ্যান্ডলিং এবং ডেলিভারি সময়ের গণনা সক্ষম করে।merchant_idএবংlineItems: আপনার Merchant Center অ্যাকাউন্টে থাকা পণ্যের সাথে অর্ডার মেলে এটি ব্যবহার করা হয়।customerShippingFee: ক্রেতার কাছে শিপিং খরচ নেওয়া হয়।
নতুন অর্ডার ট্র্যাকিং সংকেত ডেটা জমা দিন
খুচরা বিক্রেতার অর্ডার '123456789'-এর জন্য মোট 8টি আইটেম সহ একটি অর্ডার ট্র্যাকিং সংকেত জমা দেওয়ার জন্য এখানে একটি নমুনা অনুরোধ রয়েছে৷
https://merchantapi.googleapis.com/products/ordertracking/v1beta/accounts/{ACCOUNT_ID}/ordertrackingsignals
{
"merchantId": {ACCOUNT_ID},
"orderCreatedTime": {
"year": 2025,
"month": 1,
"day": 2,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"orderId": "123456789",
"shippingInfo": [
{
"shipmentId": "1",
"trackingId": "100",
"carrier": "FEDEX",
"carrierService": "GROUND",
"shippedTime": {
"year": 2025,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
},
{
"shipmentId": "2",
"earliestDeliveryPromiseTime": {
"year": 2025,
"month": 1,
"day": 4,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"latestDeliveryPromiseTime": {
"year": 2025,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"actualDeliveryTime": {
"year": 2025,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippedTime": {
"year": 2025,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
}
],
"lineItems": [
{
"lineItemId": "item1",
"productId": "online~en~US~trouser",
"quantity": "3"
},
{
"lineItemId": "item2",
"productId": "online~en~US~sneaker",
"quantity": "5"
}
],
"shipmentLineItemMapping": [
{
"shipmentId": "1",
"lineItemId": "item1",
"quantity": "1"
},
{
"shipmentId": "2",
"lineItemId": "item1",
"quantity": "2"
},
{
"shipmentId": "1",
"lineItemId": "item2",
"quantity": "4"
},
{
"shipmentId": "2",
"lineItemId": "item2",
"quantity": "1"
}
],
"customerShippingFee": {
"amount_micros": 4500000,
"currency_code": "USD"
},
"deliveryPostalCode": "94043",
"deliveryRegionCode": "US"
}
এখানে একটি সফল কল থেকে একটি নমুনা প্রতিক্রিয়া:
{
"orderCreatedTime": {
"year": 2025,
"month": 1,
"day": 2,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"orderId": "15e2b0d3c33891ebb0f1ef609ec419420c20e320ce94c65fbc8c3312448eb225",
"shippingInfo": [
{
"shipmentId": "6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b",
"trackingId": "100",
"carrier": "FEDEX",
"carrierService": "GROUND",
"shippedTime": {
"year": 2025,
"month": 1,
"day": 3,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
},
{
"shipmentId": "d4735e3a265e16eee03f59718b9b5d03019c07d8b6c51f90da3a666eec13ab35",
"shippedTime": {
"year": 2025,
"month": 1,
"day": 3,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"earliestDeliveryPromiseTime": {
"year": 2025,
"month": 1,
"day": 4,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"latestDeliveryPromiseTime": {
"year": 2025,
"month": 1,
"day": 5,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"actualDeliveryTime": {
"year": 2025,
"month": 1,
"day": 5,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
}
],
"lineItems": [
{
"lineItemId": "item1",
"productId": "online~en~US~8465944842",
"quantity": "3"
},
{
"lineItemId": "item2",
"productId": "online~en~US~8465944842",
"quantity": "5"
}
],
"shipmentLineItemMapping": [
{
"shipmentId": "6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b",
"lineItemId": "item1",
"quantity": "1"
},
{
"shipmentId": "d4735e3a265e16eee03f59718b9b5d03019c07d8b6c51f90da3a666eec13ab35",
"lineItemId": "item1",
"quantity": "2"
},
{
"shipmentId": "6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b",
"lineItemId": "item2",
"quantity": "4"
},
{
"shipmentId": "d4735e3a265e16eee03f59718b9b5d03019c07d8b6c51f90da3a666eec13ab35",
"lineItemId": "item2",
"quantity": "1"
}
],
"customerShippingFee": {
"amountMicros": "4500000",
"currencyCode": "USD"
},
"deliveryPostalCode": "94043",
"deliveryRegionCode": "US",
"orderTrackingSignalId": "2424724582881888160",
"merchantId": "1234"
}
নিম্নলিখিত কোড নমুনা দেখায় কিভাবে অর্ডার ট্র্যাকিং সংকেত ডেটা জমা দিতে হয়:
জাভা
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.ordertracking.v1beta.CreateOrderTrackingSignalRequest;
import com.google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignal;
import com.google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignal.LineItemDetails;
import com.google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignal.ShipmentLineItemMapping;
import com.google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignal.ShippingInfo;
import com.google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignal.ShippingInfo.ShippingState;
import com.google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignalsServiceClient;
import com.google.shopping.merchant.ordertracking.v1beta.OrderTrackingSignalsServiceSettings;
import com.google.shopping.type.Price;
import com.google.type.DateTime;
import com.google.type.TimeZone;
import java.util.Arrays;
import java.util.List;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;
/** This class demonstrates how to create an order tracking signal. */
public class CreateOrderTrackingSignalSample {
private static String getParent(String accountId) {
return String.format("accounts/%s", accountId);
}
private static void createOrderTrackingSignal(Config config, List<String> productIds)
throws Exception {
GoogleCredentials credentials = new Authenticator().authenticate();
OrderTrackingSignalsServiceSettings orderTrackingSignalsServiceSettings =
OrderTrackingSignalsServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(credentials))
.build();
String parent = getParent(config.getAccountId().toString());
String firstProductId = productIds.get(0);
String secondProductId = productIds.get(1);
DateTime orderCreatedTime =
DateTime.newBuilder()
.setYear(2025)
.setMonth(3)
.setDay(24)
.setHours(12)
.setMinutes(2)
.setSeconds(22)
.setTimeZone(TimeZone.newBuilder().setId("America/Los_Angeles"))
.build();
DateTime shippedTime1 =
DateTime.newBuilder()
.setYear(2025)
.setMonth(3)
.setDay(25)
.setHours(16)
.setMinutes(22)
.setTimeZone(TimeZone.newBuilder().setId("America/Los_Angeles"))
.build();
DateTime shippedTime2 =
DateTime.newBuilder()
.setYear(2025)
.setMonth(3)
.setDay(26)
.setHours(16)
.setMinutes(22)
.setTimeZone(TimeZone.newBuilder().setId("America/Los_Angeles"))
.build();
DateTime earliestDeliveryPromiseTime =
DateTime.newBuilder()
.setYear(2025)
.setMonth(3)
.setDay(27)
.setTimeZone(TimeZone.newBuilder().setId("America/Los_Angeles"))
.build();
DateTime latestDeliveryPromiseTime =
DateTime.newBuilder()
.setYear(2025)
.setMonth(3)
.setDay(30)
.setTimeZone(TimeZone.newBuilder().setId("America/Los_Angeles"))
.build();
DateTime actualDeliveryTime =
DateTime.newBuilder()
.setYear(2025)
.setMonth(3)
.setDay(29)
.setHours(16)
.setMinutes(22)
.setTimeZone(TimeZone.newBuilder().setId("America/Los_Angeles"))
.build();
ShippingInfo shippingInfo1 =
ShippingInfo.newBuilder()
.setShipmentId("shipment_id1")
.setCarrier("UPS")
.setCarrierService("Ground")
.setTrackingId("1Z23456789")
.setShippedTime(shippedTime1)
.setEarliestDeliveryPromiseTime(earliestDeliveryPromiseTime)
.setLatestDeliveryPromiseTime(latestDeliveryPromiseTime)
.setActualDeliveryTime(actualDeliveryTime)
.setShippingStatus(ShippingState.DELIVERED)
.setOriginPostalCode("94043")
.setOriginRegionCode("US")
.build();
ShippingInfo shippingInfo2 =
ShippingInfo.newBuilder()
.setShipmentId("shipment_id2")
.setCarrier("USPS")
.setCarrierService("Ground Advantage")
.setTrackingId("987654321")
.setShippedTime(shippedTime2)
.setShippingStatus(ShippingState.SHIPPED)
.setOriginPostalCode("94043")
.setOriginRegionCode("US")
.build();
try (OrderTrackingSignalsServiceClient orderTrackingSignalsServiceClient =
OrderTrackingSignalsServiceClient.create(orderTrackingSignalsServiceSettings)) {
CreateOrderTrackingSignalRequest request =
CreateOrderTrackingSignalRequest.newBuilder()
.setParent(parent)
.setOrderTrackingSignal(
OrderTrackingSignal.newBuilder()
// Unique order ID across all merchants orders.
.setOrderId("unique_order_id443455")
// If sending signal on behalf of another merchant use setMerchantId to
// indicate the merchant.
// .setMerchantId(123L)
.setOrderCreatedTime(orderCreatedTime)
.addShippingInfo(shippingInfo1)
.addShippingInfo(shippingInfo2)
// Details of the line items in the order including quantity and fields
// identifying the product.
.addLineItems(
LineItemDetails.newBuilder()
.setQuantity(2)
.setProductId(firstProductId)
.setLineItemId("item1"))
.addLineItems(
LineItemDetails.newBuilder()
.setQuantity(1)
.setProductId(secondProductId)
.setLineItemId("item2")
// Optional fields used to identify the product when product ID is not
// sufficient.
.setMpn("00638HAY")
.setProductTitle("Tshirt-small-blue")
.setBrand("Brand1")
// Any GTIN associated with the product.
.setGtin("001234567890"))
// Mapping of line items to shipments.
.addShipmentLineItemMapping(
ShipmentLineItemMapping.newBuilder()
.setShipmentId("shipment_id1")
.setLineItemId("item2")
.setQuantity(1))
.addShipmentLineItemMapping(
ShipmentLineItemMapping.newBuilder()
.setShipmentId("shipment_id2")
.setLineItemId("item1")
.setQuantity(1))
.addShipmentLineItemMapping(
ShipmentLineItemMapping.newBuilder()
.setShipmentId("shipment_id1")
.setLineItemId("item1")
.setQuantity(1))
// The price represented as a number in micros (1 million micros is an
// equivalent to one's currency standard unit, for example, 1 USD = 1000000
// micros).
.setCustomerShippingFee(
Price.newBuilder()
// Equivalent to 5 USD.
.setAmountMicros(5000000)
.setCurrencyCode("USD"))
.setDeliveryPostalCode("10011"))
.build();
System.out.println("Sending Create OrderTrackingSignal request.");
OrderTrackingSignal response =
orderTrackingSignalsServiceClient.createOrderTrackingSignal(request);
System.out.println("Created OrderTrackingSignal below.");
System.out.println(response);
} catch (Exception e) {
System.out.println(e);
}
}
public static void main(String[] args) throws Exception {
Config config = Config.load();
// All products in the order. Replace with actual products in the order. Be sure to include all
// products in the order.
String productId1 = "online~en~us~sku123";
String productId2 = "online~en~us~skuabc";
List<String> productIds = Arrays.asList(productId1, productId2);
createOrderTrackingSignal(config, productIds);
}
}
একটি খুচরা বিক্রেতার পক্ষে নতুন অর্ডার ট্র্যাকিং সংকেত ডেটা জমা দিন
একটি খুচরা বিক্রেতার পক্ষ থেকে নতুন অর্ডার ট্র্যাকিং সংকেত ডেটা জমা দিতে, প্রদত্ত পদক্ষেপগুলি অনুসরণ করুন:
- আপনি অন্য ব্যবসার পক্ষে ডেটা জমা দেওয়ার আগে নিশ্চিত করুন যে আপনি সক্ষম হয়েছেন৷ অ্যাক্সেসের অনুরোধ করতে, OrderTrackingSignals@google.com এ আমাদের সাথে যোগাযোগ করুন।
-
merchant_idক্ষেত্র সেট আপ করুন এবং ব্যবসার পক্ষে ডেটা পাঠান।
বিদ্যমান অর্ডার ট্র্যাকিং সংকেত ডেটা আপডেট করুন
ইতিমধ্যে জমা দেওয়া অর্ডার ট্র্যাকিং ডেটা সংশোধন করতে, একই orderId সহ নতুন ডেটা রয়েছে এমন একটি অনুরোধ জমা দিন। শিপিং অনুমান এবং দ্রুত এবং বিনামূল্যে ব্যাজিংয়ের জন্য, প্রতিটি orderId জন্য শুধুমাত্র সাম্প্রতিক জমা দেওয়া ডেটা ব্যবহার করা হয়।