Dịch vụ Gmail nâng cao

Dịch vụ Gmail nâng cao cho phép bạn sử dụng API Gmail trong Apps Script. Giống như dịch vụ Gmail tích hợp sẵn của Apps Script, API này cho phép các tập lệnh tìm và sửa đổi chuỗi, thư và nhãn trong Hộp thư Gmail. Trong hầu hết các trường hợp, dịch vụ tích hợp sẵn dễ sử dụng hơn, nhưng điều này dịch vụ nâng cao cung cấp một số tính năng bổ sung và quyền truy cập vào thông tin về nội dung Gmail.

Tài liệu tham khảo

Để biết thông tin chi tiết về dịch vụ này, hãy xem tài liệu tham khảo về API Gmail. Giống như tất cả các dịch vụ nâng cao trong Apps Script, dịch vụ Gmail nâng cao sử dụng các đối tượng, phương thức và tham số giống với API công khai. Để biết thêm thông tin, hãy xem bài viết Cách xác định chữ ký phương thức.

Để báo cáo sự cố và tìm hỗ trợ khác, hãy xem Hướng dẫn hỗ trợ của Gmail.

Mã mẫu

Mã mẫu bên dưới sử dụng phiên bản 1 của API.

Liệt kê thông tin về nhãn

Ví dụ sau minh hoạ cách liệt kê tất cả thông tin về nhãn của người dùng. Thông tin này bao gồm tên nhãn, loại, mã nhận dạng và chế độ hiển thị.

nâng cao/gmail.gs
/**
 * Lists the user's labels, including name, type,
 * ID and visibility information.
 */
function listLabelInfo() {
  try {
    const response =
      Gmail.Users.Labels.list('me');
    for (let i = 0; i < response.labels.length; i  ) {
      const label = response.labels[i];
      console.log(JSON.stringify(label));
    }
  } catch (err) {
    console.log(err);
  }
}

Liệt kê đoạn trích trong hộp thư đến

Ví dụ sau minh hoạ cách liệt kê các đoạn văn bản được liên kết với từng chuỗi thư trong Hộp thư đến của người dùng. Lưu ý việc sử dụng mã thông báo trang để truy cập vào danh sách đầy đủ các kết quả.

nâng cao/gmail.gs
/**
 * Lists, for each thread in the user's Inbox, a
 * snippet associated with that thread.
 */
function listInboxSnippets() {
  try {
    let pageToken;
    do {
      const threadList = Gmail.Users.Threads.list('me', {
        q: 'label:inbox',
        pageToken: pageToken
      });
      if (threadList.threads && threadList.threads.length > 0) {
        threadList.threads.forEach(function(thread) {
          console.log('Snippet: %s', thread.snippet);
        });
      }
      pageToken = threadList.nextPageToken;
    } while (pageToken);
  } catch (err) {
    console.log(err);
  }
}

Liệt kê nhật ký gần đây

Ví dụ sau minh hoạ cách ghi nhật ký hoạt động gần đây. Cụ thể, ví dụ này khôi phục mã bản ghi lịch sử được liên kết với thư gần đây nhất của người dùng, rồi ghi lại mã nhận dạng thư của mỗi đã thay đổi kể từ thời điểm đó. Mỗi thông báo được thay đổi chỉ được ghi lại một lần, bất kể có bao nhiêu sự kiện thay đổi trong bản ghi lịch sử. Lưu ý sử dụng mã thông báo trang để truy cập danh sách kết quả đầy đủ.

nâng cao/gmail.gs
/**
 * Gets a history record ID associated with the most
 * recently sent message, then logs all the message IDs
 * that have changed since that message was sent.
 */
function logRecentHistory() {
  try {
    // Get the history ID associated with the most recent
    // sent message.
    const sent = Gmail.Users.Threads.list('me', {
      q: 'label:sent',
      maxResults: 1
    });
    if (!sent.threads || !sent.threads[0]) {
      console.log('No sent threads found.');
      return;
    }
    const historyId = sent.threads[0].historyId;

    // Log the ID of each message changed since the most
    // recent message was sent.
    let pageToken;
    const changed = [];
    do {
      const recordList = Gmail.Users.History.list('me', {
        startHistoryId: historyId,
        pageToken: pageToken
      });
      const history = recordList.history;
      if (history && history.length > 0) {
        history.forEach(function(record) {
          record.messages.forEach(function(message) {
            if (changed.indexOf(message.id) === -1) {
              changed.push(message.id);
            }
          });
        });
      }
      pageToken = recordList.nextPageToken;
    } while (pageToken);

    changed.forEach(function(id) {
      console.log('Message Changed: %s', id);
    });
  } catch (err) {
    console.log(err);
  }
}