टास्क ढूंढें

इस दस्तावेज़ में, सर्वर या ब्राउज़र से टास्क की जानकारी पाने के तरीकों के बारे में बताया गया है. Fleet Engine, टास्क की जानकारी पाने के दो तरीके उपलब्ध कराता है:

• टास्क ढूंढना: टास्क को इन आईडी की मदद से ढूंढा जा सकता है:

  • टास्क आईडी: इसका इस्तेमाल उन उपयोगकर्ताओं के लिए किया जाता है जिनके पास टास्क के डेटा का पूरा व्यू ऐक्सेस करने की अनुमति होती है. जैसे, फ़्लीट ऑपरेटर.
  • ट्रैकिंग आईडी: इसका इस्तेमाल, क्लाइंट सॉफ़्टवेयर करता है, ताकि असली उपयोगकर्ता को सीमित जानकारी दी जा सके. जैसे, पैकेज कब तक उसके घर पहुंच सकता है.

  टास्क आईडी और टास्क ट्रैकिंग आईडी के बीच का अंतर समझें. ये दोनों आईडी अलग-अलग होते हैं. शेड्यूल किए गए टास्क की गाइड में, टास्क के बुनियादी फ़ील्ड देखें.

• टास्क की सूची देखना: टास्क को ऐक्सेस करने की यह सुविधा, सिर्फ़ भरोसेमंद उपयोगकर्ताओं के लिए है.

टास्क ढूंढना

इस सेक्शन में, टास्क आईडी या ट्रैकिंग आईडी की मदद से टास्क ढूंढने का तरीका बताया गया है. इसके लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:

• ट्रैकिंग आईडी की मदद से टास्क ढूंढने के लिए, ट्रैक किए गए ऑब्जेक्ट की विज़िबिलिटी के नियमों का पालन करना होगा ट्रैक किए गए ऑब्जेक्ट की विज़िबिलिटी के नियम.

• सुरक्षा से जुड़े जोखिमों को कम करने के लिए, सबसे सीमित ऐक्सेस वाला टोकन इस्तेमाल करें. उदाहरण के लिए, अगर डिलीवरी के ग्राहक का टोकन इस्तेमाल किया जाता है, तो सभी कॉल सिर्फ़ असली उपयोगकर्ता से जुड़ी जानकारी दिखाती हैं. जैसे, शिपमेंट भेजने वाला या पाने वाला व्यक्ति. Fleet Engine, जवाबों में मौजूद अन्य सभी जानकारी को छिपा देता है. टोकन के बारे में ज़्यादा जानने के लिए, JSON वेब टोकन देखें.

टास्क आईडी की मदद से टास्क ढूंढना

gRPC या REST का इस्तेमाल करके, सर्वर एनवायरमेंट से टास्क आईडी की मदद से टास्क ढूंढा जा सकता है. यहां दिए गए उदाहरणों में, Java gRPC लाइब्रेरी या GetTask के लिए REST अनुरोध का इस्तेमाल करने का तरीका बताया गया है.

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8597549";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task request
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 GetTaskRequest getTaskRequest = GetTaskRequest.newBuilder()  // No need for the header
     .setName(taskName)
     .build();

 try {
   Task task = deliveryService.getTask(getTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

    # Set JWT, PROJECT_ID, and TASK_ID in the local environment
    curl -H "Authorization: Bearer ${JWT}" \
      "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}"

ट्रैकिंग आईडी की मदद से टास्क ढूंढना

यहां दिए गए उदाहरणों में, शिपमेंट के ट्रैकिंग आईडी की मदद से टास्क ढूंढने का तरीका बताया गया है. इसके लिए, gRPC या GetTaskTrackingInfo के लिए एचटीटीपी REST कॉल का इस्तेमाल किया जा सकता है.

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TRACKING_ID = "TID-7449w087464x5";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Tasks request
String parent = "providers/" + PROJECT_ID;
GetTaskTrackingInfoRequest getTaskTrackingInfoRequest = GetTaskTrackingInfoRequest.newBuilder()  // No need for the header
    .setParent(parent)
    .setTrackingId(TRACKING_ID)
    .build();

try {
  TaskTrackingInfo taskTrackingInfo = deliveryService.getTaskTrackingInfo(getTaskTrackingInfoRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;

     case PERMISSION_DENIED:
       break;
  }
  return;
}

# Set JWT, PROJECT_ID, and TRACKING_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
  "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/taskTrackingInfo/${TRACKING_ID}"

टास्क की सूची देखना

टास्क की सूची देखने के अनुरोधों के लिए, टास्क को ऐक्सेस करने की अनुमति ज़रूरी होती है. टास्क की सूची देखने की सुविधा, सिर्फ़ भरोसेमंद उपयोगकर्ताओं के लिए है. टास्क की सूची देखने के अनुरोध करते समय, डिलीवरी फ़्लीट रीडर या डिलीवरी एडमिन के पुष्टि करने वाले टोकन का इस्तेमाल करें. ज़्यादा जानकारी के लिए, सेवा खाते की भूमिकाएं देखें.

सूचियों को पेजों में बांटना

टास्क की सूचियां पेजों में बंटी होती हैं. टास्क की सूची देखने के अनुरोधों में, पेज का साइज़ तय किया जा सकता है. अगर पेज का साइज़ तय किया जाता है, तो दिखाए गए टास्क की संख्या, तय किए गए पेज के साइज़ से ज़्यादा नहीं होती. अगर पेज का साइज़ तय नहीं किया जाता है, तो डिफ़ॉल्ट साइज़ का इस्तेमाल किया जाता है. अगर अनुरोध किया गया पेज साइज़, तय की गई ज़्यादा से ज़्यादा वैल्यू से ज़्यादा है, तो तय की गई ज़्यादा से ज़्यादा वैल्यू का इस्तेमाल किया जाता है.

टास्क की सूची में, नतीजों का अगला पेज पढ़ने के लिए टोकन शामिल किया जा सकता है. अगला पेज पाने के लिए, पेज टोकन के साथ वही अनुरोध फिर से जारी करें. जब दिखाया गया पेज टोकन खाली होता है, तो टास्क को वापस पाने के लिए कोई और टास्क उपलब्ध नहीं होता.

टास्क की सूची देखते समय दिखने वाले फ़ील्ड

Fleet Engine, टास्क की सूची देखते समय इन फ़ील्ड को छिपा देता है:

• VehicleStop.planned_location
• VehicleStop.state
• VehicleStop.TaskInfo.taskId

Google API को बेहतर बनाने के सुझावों के आधार पर, इन फ़ील्ड के फ़ॉर्मैट का इस्तेमाल करें:

सूची में शामिल टास्क को फ़िल्टर करना

सूची में शामिल टास्क को, टास्क की ज़्यादातर प्रॉपर्टी के हिसाब से फ़िल्टर किया जा सकता है. फ़िल्टर क्वेरी के सिंटैक्स के लिए, देखें AIP-160. अगर फ़िल्टर क्वेरी तय नहीं की जाती है, तो सभी टास्क की सूची दिखाई जाती है.

यहां दी गई टेबल में, टास्क की उन मान्य प्रॉपर्टी के बारे में बताया गया है जिनका इस्तेमाल फ़िल्टर करने के लिए किया जा सकता है:

फ़िल्टर क्वेरी ऑपरेटर की पूरी सूची के लिए, AIP-160 देखें.

टास्क की सूची के उदाहरण

यहां दिए गए उदाहरण में, deliveryVehicleId और टास्क के एट्रिब्यूट के लिए टास्क की सूची देखने का तरीका बताया गया है. इसके लिए, Java gRPC library और ListTasks के लिए एचटीटीपी REST कॉल, दोनों का इस्तेमाल किया गया है.

अनुरोध पूरा होने पर भी, जवाब खाली हो सकता है. खाली जवाब का मतलब है कि दिए गए deliveryVehicleId से जुड़े कोई टास्क नहीं हैं.

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TRACKING_ID = "TID-7449w087464x5";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Tasks request
 String parent = "providers/" + PROJECT_ID;
 ListTasksRequest listTasksRequest = ListTasksRequest.newBuilder()  // No need for the header
     .setParent(parent)
     .setFilter("delivery_vehicle_id = 123 AND attributes.foo = true")
     .build();

 try {
   ListTasksResponse listTasksResponse = deliveryService.listTasks(listTasksRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

    // JSON representation
    {
      "tasks": [
        {
          object (Task)
        }
      ],
      "nextPageToken": string,
      "totalSize": integer
    }

 # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
 curl -H "Authorization: Bearer ${JWT}" \
   "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?filter=state%20%3D%20OPEN%20AND%20delivery_vehicle_id%20%3D%20${VEHICLE_ID}"

आगे क्या करना है

• शिपमेंट मैनेज करना