البدء السريع بلغة Java

توضّح الخطوات السريعة كيفية إعداد تطبيق يستدعي واجهة برمجة التطبيقات Google Workspace API وتشغيله.

تستخدِم عمليات الإعداد السريع في Google Workspace مكتبات عملاء واجهة برمجة التطبيقات لمعالجة بعض تفاصيل عملية المصادقة والتفويض. ننصحك باستخدام مكتبات العملاء لتطبيقاتك. يستخدم دليل البدء السريع هذا أسلوب مصادقة بسيطًا ومناسبًا لبيئة الاختبار. بالنسبة إلى بيئة الإنتاج، ننصحك بالاطّلاع على معلومات عن المصادقة والتفويض قبل اختيار بيانات اعتماد الوصول الملائمة لتطبيقك.

أنشئ تطبيق سطر أوامر Java يُرسل طلبات إلى Google Drive Activity API.

الأهداف

  • اضبط إعدادات البيئة.
  • إعداد العيّنة
  • شغِّل العيّنة.

المتطلبات الأساسية

  • حساب Google

إعداد البيئة

لإكمال عملية الإعداد السريعة هذه، عليك إعداد بيئتك.

تفعيل واجهة برمجة التطبيقات

قبل استخدام واجهات برمجة تطبيقات Google، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.

إذا كنت تستخدِم مشروعًا جديدًا على Google Cloud لإكمال خطوات البدء السريع هذه، عليك ضبط شاشة موافقة OAuth وإضافتك كمستخدم تجريبي. إذا سبق أن اكتملت هذه الخطوة لمشروعك على Cloud، انتقِل إلى القسم التالي.

  1. في وحدة تحكّم Google Cloud، انتقِل إلى رمز القائمة > APIs & Services (واجهات برمجة التطبيقات والخدمات) > OAuth consent screen (شاشة موافقة OAuth).

    الانتقال إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

  2. في حقل نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
  3. املأ نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.

  4. في الوقت الحالي، يمكنك تخطّي إضافة النطاقات والنقر على حفظ ومتابعة. في المستقبل، عند إنشاء تطبيق لاستخدامه خارج مؤسستك على Google Workspace، عليك تغيير نوع المستخدم إلى خارجي، ثم إضافة نطاقات التفويض التي يتطلبها تطبيقك.

  5. راجِع ملخّص تسجيل تطبيقك. لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو جيدًا، انقر على الرجوع إلى لوحة البيانات.

تفويض بيانات الاعتماد لتطبيق على الكمبيوتر المكتبي

لمصادقة المستخدمين النهائيين والوصول إلى بيانات المستخدمين في تطبيقك، عليك إنشاء معرّف عميل واحد أو أكثر من معرّفات OAuth 2.0. يُستخدَم معرّف العميل لتحديد تطبيق واحد على خوادم OAuth في Google. إذا كان تطبيقك يعمل على منصات متعددة، يجب إنشاء معرّف عميل منفصل لكل منصة.
  1. في وحدة تحكّم Google Cloud، انتقِل إلى رمز القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.

    الانتقال إلى "بيانات الاعتماد"

  2. انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
  3. انقر على نوع التطبيق > تطبيق كمبيوتر مكتبي.
  4. في حقل الاسم، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في "وحدة تحكّم Google Cloud".
  5. انقر على إنشاء. تظهر شاشة "تم إنشاء عميل OAuth"، والتي تعرض معرّف العميل الجديد وسرّه.
  6. انقر على موافق. تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن معرِّفات عملاء OAuth 2.0.
  7. احفظ ملف JSON الذي تم تنزيله باسم credentials.json، وانقل ملف إلى دليل العمل.

إعداد مساحة العمل

  1. في دليل العمل، أنشئ بنية مشروع جديدة:

    gradle init --type basic
mkdir -p src/main/java src/main/resources

  2. في الدليل src/main/resources/، انسخ ملف credentials.json الذي نزّلته سابقًا.

  3. افتح ملف build.gradle التلقائي واستبدِل محتوياته بالرمز التالي:

    drive/activity-v2/quickstart/build.gradle
    apply plugin: 'java'
apply plugin: 'application'

mainClassName = 'DriveActivityQuickstart'
sourceCompatibility = 11
targetCompatibility = 11
version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.google.api-client:google-api-client:2.0.0'
    implementation 'com.google.oauth-client:google-oauth-client-jetty:1.34.1'
    implementation 'com.google.apis:google-api-services-driveactivity:v2-rev20220926-2.0.0'
}

إعداد العيّنة

  1. في الدليل src/main/java/، أنشِئ ملف Java جديدًا باسم يتطابق مع قيمة mainClassName في ملف build.gradle.

  2. أدرِج الرمز التالي في ملف Java الجديد:

    drive/activity-v2/quickstart/src/main/java/DriveActivityQuickstart.java
    import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.client.util.store.FileDataStoreFactory;
import com.google.api.services.driveactivity.v2.DriveActivityScopes;
import com.google.api.services.driveactivity.v2.model.*;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.AbstractMap;
import java.util.Arrays;
import java.util.Iterator;
import java.util.List;
import java.util.stream.Collectors;

public class DriveActivityQuickstart {
  /**
   * Application name.
   */
  private static final String APPLICATION_NAME = "Drive Activity API Java Quickstart";

  /**
   * Directory to store authorization tokens for this application.
   */
  private static final java.io.File DATA_STORE_DIR = new java.io.File("tokens");
  /**
   * Global instance of the JSON factory.
   */
  private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
  /**
   * Global instance of the scopes required by this quickstart.
   *
   * <p>If modifying these scopes, delete your previously saved tokens/ folder.
   */
  private static final List<String> SCOPES =
      Arrays.asList(DriveActivityScopes.DRIVE_ACTIVITY_READONLY);
  private static final String CREDENTIALS_FILE_PATH = "/credentials.json";
  /**
   * Global instance of the {@link FileDataStoreFactory}.
   */
  private static FileDataStoreFactory DATA_STORE_FACTORY;
  /**
   * Global instance of the HTTP transport.
   */
  private static HttpTransport HTTP_TRANSPORT;

  static {
    try {
      HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
      DATA_STORE_FACTORY = new FileDataStoreFactory(DATA_STORE_DIR);
    } catch (Throwable t) {
      t.printStackTrace();
      System.exit(1);
    }
  }

  /**
   * Creates an authorized Credential object.
   *
   * @return an authorized Credential object.
   * @throws IOException
   */
  public static Credential authorize() throws IOException {
    // Load client secrets.
    InputStream in = DriveActivityQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);
    if (in == null) {
      throw new FileNotFoundException("Resource not found: " + CREDENTIALS_FILE_PATH);
    }
    GoogleClientSecrets clientSecrets =
        GoogleClientSecrets.load(JSON_FACTORY, new InputStreamReader(in));

    // Build flow and trigger user authorization request.
    GoogleAuthorizationCodeFlow flow =
        new GoogleAuthorizationCodeFlow.Builder(
            HTTP_TRANSPORT, JSON_FACTORY, clientSecrets, SCOPES)
            .setDataStoreFactory(DATA_STORE_FACTORY)
            .setAccessType("offline")
            .build();
    Credential credential =
        new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver())
            .authorize("user");
    System.out.println("Credentials saved to " + DATA_STORE_DIR.getAbsolutePath());
    return credential;
  }

  /**
   * Build and return an authorized Drive Activity client service.
   *
   * @return an authorized DriveActivity client service
   * @throws IOException
   */
  public static com.google.api.services.driveactivity.v2.DriveActivity getDriveActivityService()
      throws IOException {
    Credential credential = authorize();
    com.google.api.services.driveactivity.v2.DriveActivity service =
        new com.google.api.services.driveactivity.v2.DriveActivity.Builder(
            HTTP_TRANSPORT, JSON_FACTORY, credential)
            .setApplicationName(APPLICATION_NAME)
            .build();
    return service;
  }

  public static void main(String[] args) throws IOException {
    // Build a new authorized API client service.
    com.google.api.services.driveactivity.v2.DriveActivity service = getDriveActivityService();

    // Print the recent activity in your Google Drive.
    QueryDriveActivityResponse result =
        service.activity().query(new QueryDriveActivityRequest().setPageSize(10)).execute();
    List<DriveActivity> activities = result.getActivities();
    if (activities == null || activities.size() == 0) {
      System.out.println("No activity.");
    } else {
      System.out.println("Recent activity:");
      for (DriveActivity activity : activities) {
        String time = getTimeInfo(activity);
        String action = getActionInfo(activity.getPrimaryActionDetail());
        List<String> actors =
            activity.getActors().stream()
                .map(DriveActivityQuickstart::getActorInfo)
                .collect(Collectors.toList());
        List<String> targets =
            activity.getTargets().stream()
                .map(DriveActivityQuickstart::getTargetInfo)
                .collect(Collectors.toList());
        System.out.printf(
            "%s: %s, %s, %s\n", time, truncated(actors), action, truncated(targets));
      }
    }
  }

  /**
   * Returns a string representation of the first elements in a list.
   */
  private static String truncated(List<String> array) {
    return truncatedTo(array, 2);
  }

  /**
   * Returns a string representation of the first elements in a list.
   */
  private static String truncatedTo(List<String> array, int limit) {
    String contents = array.stream().limit(limit).collect(Collectors.joining(", "));
    String more = array.size() > limit ? ", ..." : "";
    return "[" + contents + more + "]";
  }

  /**
   * Returns the name of a set property in an object, or else "unknown".
   */
  private static <T> String getOneOf(AbstractMap<String, T> obj) {
    Iterator<String> iterator = obj.keySet().iterator();
    return iterator.hasNext() ? iterator.next() : "unknown";
  }

  /**
   * Returns a time associated with an activity.
   */
  private static String getTimeInfo(DriveActivity activity) {
    if (activity.getTimestamp() != null) {
      return activity.getTimestamp();
    }
    if (activity.getTimeRange() != null) {
      return activity.getTimeRange().getEndTime();
    }
    return "unknown";
  }

  /**
   * Returns the type of action.
   */
  private static String getActionInfo(ActionDetail actionDetail) {
    return getOneOf(actionDetail);
  }

  /**
   * Returns user information, or the type of user if not a known user.
   */
  private static String getUserInfo(User user) {
    if (user.getKnownUser() != null) {
      KnownUser knownUser = user.getKnownUser();
      Boolean isMe = knownUser.getIsCurrentUser();
      return (isMe != null && isMe) ? "people/me" : knownUser.getPersonName();
    }
    return getOneOf(user);
  }

  /**
   * Returns actor information, or the type of actor if not a user.
   */
  private static String getActorInfo(Actor actor) {
    if (actor.getUser() != null) {
      return getUserInfo(actor.getUser());
    }
    return getOneOf(actor);
  }

  /**
   * Returns the type of a target and an associated title.
   */
  private static String getTargetInfo(Target target) {
    if (target.getDriveItem() != null) {
      return "driveItem:\"" + target.getDriveItem().getTitle() + "\"";
    }
    if (target.getDrive() != null) {
      return "drive:\"" + target.getDrive().getTitle() + "\"";
    }
    if (target.getFileComment() != null) {
      DriveItem parent = target.getFileComment().getParent();
      if (parent != null) {
        return "fileComment:\"" + parent.getTitle() + "\"";
      }
      return "fileComment:unknown";
    }
    return getOneOf(target);
  }
}

تشغيل العيّنة

  1. شغِّل العيّنة:

    gradle run
  1. في المرة الأولى التي تُشغِّل فيها العيّنة، سيُطلب منك تفويض الوصول:
    1. إذا لم تكن مسجِّلاً الدخول إلى حسابك على Google، سجِّل الدخول عندما يُطلب منك ذلك. إذا كنت مسجِّلاً الدخول إلى حسابات متعددة، اختَر حسابًا واحدًا لاستخدامه في التفويض.
    2. انقر على قبول.

    يتم تشغيل تطبيق Java وطلب بيانات من Google Drive Activity API.

    يتم تخزين معلومات التفويض في نظام الملفات، لذا لن يُطلب منك التفويض في المرة التالية التي تُشغّل فيها نموذج الرمز المبرمَج.

الخطوات التالية