خدمة مهام Google

تسمح لك خدمة مهام Google باستخدام واجهة برمجة تطبيقات "مهام Google" في "برمجة تطبيقات Google" واجهة برمجة التطبيقات هذه للمستخدمين إمكانية إدارة مهامهم في Gmail.

ملاحظة: هذه خدمة متقدّمة يجب أن تكون يتم تفعيلها قبل الاستخدام.

مَراجع

للحصول على معلومات تفصيلية حول هذه الخدمة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بواجهة برمجة تطبيقات "مهام Google". مثل جميع الخدمات المتقدمة في برمجة التطبيقات، تستخدم خدمة "مهام Google" نفس والكائنات والطرق والمعلمات باعتبارها واجهة برمجة التطبيقات العامة. لمزيد من المعلومات، يُرجى الاطِّلاع على كيفية تحديد توقيعات الطرق.

للإبلاغ عن المشاكل والعثور على خدمات داعمة أخرى، يُرجى الاطّلاع على دليل دعم "مهام Google"

نموذج تطبيق

يوضح نموذج تطبيق الويب Simple Tasks كيفية استخدام مهام Google لكل من عمليتَي القراءة والكتابة. يمكنك عرض رمز المصدر بالكامل في مستودع GitHub.

نموذج التعليمات البرمجية

يستخدم الرمز النموذجي أدناه الإصدار 1 من واجهة برمجة التطبيقات.

سرد قوائم المهام

يعرض هذا النموذج قوائم المهام في حسابك.

Advanced/tasks.gs

عرض على GitHub

/**
 * Lists the titles and IDs of tasksList.
 * @see https://developers.google.com/tasks/reference/rest/v1/tasklists/list
 */
function listTaskLists() {
  try {
    // Returns all the authenticated user's task lists.
    const taskLists = Tasks.Tasklists.list();
    // If taskLists are available then print all tasklists.
    if (!taskLists.items) {
      console.log('No task lists found.');
      return;
    }
    // Print the tasklist title and tasklist id.
    for (let i = 0; i < taskLists.items.length; i++) {
      const taskList = taskLists.items[i];
      console.log('Task list with title "%s" and ID "%s" was found.', taskList.title, taskList.id);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Task API
    console.log('Failed with an error %s ', err.message);
  }
}

سرد المهام

يسرد هذا النموذج المهام ضمن قائمة مهام معينة.

Advanced/tasks.gs

عرض على GitHub

/**
 * Lists task items for a provided tasklist ID.
 * @param  {string} taskListId The tasklist ID.
 * @see https://developers.google.com/tasks/reference/rest/v1/tasks/list
 */
function listTasks(taskListId) {
  try {
    // List the task items of specified tasklist using taskList id.
    const tasks = Tasks.Tasks.list(taskListId);
    // If tasks are available then print all task of given tasklists.
    if (!tasks.items) {
      console.log('No tasks found.');
      return;
    }
    // Print the task title and task id of specified tasklist.
    for (let i = 0; i < tasks.items.length; i++) {
      const task = tasks.items[i];
      console.log('Task with title "%s" and ID "%s" was found.', task.title, task.id);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Task API
    console.log('Failed with an error %s', err.message);
  }
}

إضافة مهمّة

يضيف هذا النموذج مهمة جديدة إلى قائمة مهام.

Advanced/tasks.gs

عرض على GitHub

/**
 * Adds a task to a tasklist.
 * @param {string} taskListId The tasklist to add to.
 * @see https://developers.google.com/tasks/reference/rest/v1/tasks/insert
 */
function addTask(taskListId) {
  // Task details with title and notes for inserting new task
  let task = {
    title: 'Pick up dry cleaning',
    notes: 'Remember to get this done!'
  };
  try {
    // Call insert method with taskDetails and taskListId to insert Task to specified tasklist.
    task = Tasks.Tasks.insert(task, taskListId);
    // Print the Task ID of created task.
    console.log('Task with ID "%s" was created.', task.id);
  } catch (err) {
    // TODO (developer) - Handle exception from Tasks.insert() of Task API
    console.log('Failed with an error %s', err.message);
  }
}