लंबे समय तक चलने वाली कार्रवाइयां (LRO)

एपीआई को कई कॉल करने पर, लंबे समय तक चलने वाली कार्रवाइयां दिखती हैं. ये लंबे समय तक चलने वाले काम की स्थिति को ट्रैक करते हैं, जैसे कि RPC को ब्लॉक करना ज़रूरी नहीं है.

ActionsFuture क्लास

एलआरओ के साथ इंटरैक्ट करने का सबसे आसान तरीका है, OperationFuture क्लास का इस्तेमाल करना. अगर इसका इस्तेमाल किया जाता है, तो पक्का करें कि सर्विस क्लाइंट खत्म न हो.

इसका सुझाव नहीं दिया जाता:

private void doSomething() {
  OperationFuture<Empty, Empty> future = startLongRunningOperation(jobName);
  future.get();
}

private OperationFuture<Empty, Empty> startLongRunningOperation(String jobToStart)
    throws UnsupportedEncodingException {
  try (OfflineUserDataJobServiceClient offlineUserDataJobServiceClient =
      googleAdsClient.getLatestVersion().createOfflineUserDataJobServiceClient()) {
    // Issues an asynchronous request to run the offline user data job for executing
    // all added operations.
    return offlineUserDataJobServiceClient.runOfflineUserDataJobAsync(jobToStart);
  }
}

सुझाया गया:

private void doSomethingElse() {
  try (OfflineUserDataJobServiceClient offlineUserDataJobServiceClient =
      googleAdsClient.getLatestVersion().createOfflineUserDataJobServiceClient()) {
    OperationFuture<Empty, Empty> future = startLongRunningOperation(offlineUserDataJobServiceClient, jobName);
    future.get();
  }
}

private OperationFuture<Empty, Empty> startLongRunningOperation(String jobToStart)
    throws UnsupportedEncodingException {
    offlineUserDataJobServiceClient.runOfflineUserDataJobAsync(jobToStart);
}

ध्यान दें कि कैसे OperationFuture क्लास का इस्तेमाल सिर्फ़ तब किया जाता है, जब OfflineUserDataJobServiceClient स्कोप में हो.