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 của Apps Script, API này cho phép các tập lệnh tìm và sửa đổi các 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 sẽ dễ sử dụng hơn. Tuy nhiên, dịch vụ nâng cao này cung cấp thêm một số tính năng và quyền truy cập vào thông tin chi tiết hơn 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 dành cho 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ùng đối tượng, phương thức và tham số như API công khai. Để biết thêm thông tin, hãy xem phần Cách xác định chữ ký phương thức.

Để báo cáo sự cố và tìm nguồn 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 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 nhãn, mã nhận dạng và chế độ cài đặt chế độ hiển thị.

advanced/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 mã hộp thư đến

Ví dụ sau minh hoạ cách liệt kê các đoạn văn bản liên kết với từng chuỗi 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ả.

advanced/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ê lịch sử gần đây

Ví dụ sau đây minh hoạ cách ghi lại nhật ký hoạt động gần đây. Cụ thể, ví dụ này khôi phục mã bản ghi nhật ký liên kết với tin nhắn gửi gần đây nhất của người dùng, sau đó ghi lại mã nhận dạng tin nhắn của mọi tin nhắn đã thay đổi kể từ thời điểm đó. Mỗi thông báo đã 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 nhật ký. Hãy lưu ý việc sử dụng mã thông báo trang để truy cập toàn bộ danh sách kết quả.

advanced/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);
  }
}