【コピペOK】GASでX(旧Twitter)の投稿を完全自動化する方法｜元ITパパ

/**
 * X（旧Twitter）投稿自動化スクリプト Ver. 1.0
 * * このスクリプトは、ブログ「シュウの備忘録」の読者のために提供されています。
 * * @author   シュウ（元ITパパ）
 * @blog     シュウの備忘録
 * @url      https://shu-note.com/
 * @license  改変、再配布はご自由ですが、その際は出典元として当ブログへのリンクを明記していただけると嬉しいです。
 */

// === スクリプトプロパティから認証情報を取得 ===
// セキュリティのため、APIキーやIDはここに直接書き込まず、
// GASの「プロジェクトの設定」>「スクリプト プロパティ」に保存してください。
const SCRIPT_PROPERTIES = PropertiesService.getScriptProperties();
const consumerKey = SCRIPT_PROPERTIES.getProperty("consumerKey");
const consumerSecret = SCRIPT_PROPERTIES.getProperty("consumerSecret");
const accessToken = SCRIPT_PROPERTIES.getProperty("accessToken");
const accessSecret = SCRIPT_PROPERTIES.getProperty("accessSecret");
const SPREADSHEET_ID = SCRIPT_PROPERTIES.getProperty("SPREADSHEET_ID");

// === 基本設定 ===
const SHEET_NAME = "PostSchedule"; // あなたが使用するシート名に合わせてください

// ===============================================================
// ■ メインの実行関数
// この「main」関数を、10分または15分おきのトリガーで実行してください。
// ===============================================================
function main() {
  const now = new Date();
  const sheet = SpreadsheetApp.openById(SPREADSHEET_ID).getSheetByName(SHEET_NAME);
  if (!sheet) {
    Logger.log("エラー: シートが見つかりません。シート名を確認してください。");
    return;
  }
  const data = sheet.getDataRange().getValues();

  // --- 1. 時間指定投稿を最優先でチェック ---
  for (let i = 1; i < data.length; i++) {
    const postDate = data[i][2]; // C列: 投稿予定日
    const postTime = data[i][3]; // D列: 投稿予定時刻
    const postedTime = data[i][4]; // E列: 投稿済み日時

    // 投稿予定日時があり、まだ投稿されていないものを探す
    if (postDate instanceof Date && postTime instanceof Date && !postedTime) {
      // 日付と時刻を組み合わせて、一つのDateオブジェクトを生成
      const scheduledTime = new Date(
        postDate.getFullYear(),
        postDate.getMonth(),
        postDate.getDate(),
        postTime.getHours(),
        postTime.getMinutes()
      );

      if (scheduledTime <= now) {
        const textToPost = data[i][0]; // A列: 投稿内容
        Logger.log(`時間指定投稿を実行します: ${textToPost}`);
        const result = postToTwitter(textToPost);
        if (result) {
          sheet.getRange(i + 1, 5).setValue(new Date()); // E列に投稿日時を記録
        }
        return; // 1回の実行で1投稿のみなので、ここで処理を終了
      }
    }
  }

  // --- 2. 時間指定投稿がなければ、定時ランダム投稿をチェック ---
  const currentHour = now.getHours();

  if (currentHour === 8) { // 朝8時台なら「豆知識」を投稿
    Logger.log("朝の「豆知識」投稿を試みます。");
    postRandomTweetByType("豆知識", sheet, data);
  } else if (currentHour === 12) { // 昼12時台なら「過去記事」を投稿
    Logger.log("昼の「過去記事」投稿を試みます。");
    postRandomTweetByType("過去記事", sheet, data);
  }
}

/**
 * [内部関数] 指定された「種別」の中から、未投稿のツイートを1つランダムに選び投稿
 * @param {string} type - 投稿したいツイートの種別 (B列の値)
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet - 対象シート
 * @param {Array<Array<any>>} data - シートの全データ
 */
function postRandomTweetByType(type, sheet, data) {
  // 本日、同じ種別の投稿が既に完了しているかチェック
  const today = new Date();
  today.setHours(0, 0, 0, 0); // 今日の日付の0時0分

  for (let i = 1; i < data.length; i++) {
    const postType = data[i][1];     // B列: 種別
    const postedTime = data[i][3]; // D列: 投稿済み日時

    if (postedTime instanceof Date && postType === type) {
      const postedDate = new Date(postedTime);
      postedDate.setHours(0, 0, 0, 0); // 投稿日の0時0分
      
      if (today.getTime() === postedDate.getTime()) {
        Logger.log(`本日、種別'${type}'の投稿は既に完了しています。`);
        return; // 今日のこの種別の投稿は終わり
      }
    }
  }

  // 投稿候補をリストアップ
  const candidates = [];
  for (let i = 1; i < data.length; i++) {
    const text = data[i][0]; // A列: 投稿内容
    const postType = data[i][1]; // B列: 種別
    const postedTime = data[i][3]; // D列: 投稿済み日時
    
    // 投稿内容があり、種別が一致し、まだ投稿されていないものを候補とする
    if (text && postType === type && !postedTime) {
      candidates.push({
        row: i + 1, // 行番号 (1始まり)
        text: text,
      });
    }
  }

  // 投稿できる候補がなければ終了
  if (candidates.length === 0) {
    Logger.log(`'${type}'で投稿できるツイートがありませんでした。`);
    return;
  }
  
  // 候補の中からランダムで1つ選ぶ
  const selectedTweet = candidates[Math.floor(Math.random() * candidates.length)];
  
  // Xに投稿
  const result = postToTwitter(selectedTweet.text);
  
  // 成功したらD列に投稿日時を記録
  if (result) {
    sheet.getRange(selectedTweet.row, 4).setValue(new Date());
  }
}


/**
 * [X投稿実行関数] X（旧Twitter）にツイートを投稿する
 * @param {string} tweetText 投稿するテキスト
 */
function postToTwitter(tweetText) {
  const apiUrl = "https://api.twitter.com/2/tweets";
  const method = "POST";

  const nonce = Utilities.getUuid().replace(/-/g, "");
  const timestamp = Math.floor(Date.now() / 1000).toString();

  const oauthParams = {
    oauth_consumer_key: consumerKey,
    oauth_nonce: nonce,
    oauth_signature_method: "HMAC-SHA1",
    oauth_timestamp: timestamp,
    oauth_token: accessToken,
    oauth_version: "1.0",
  };

  const baseParams = Object.keys(oauthParams).sort().map(key => 
    `${encodeURIComponent(key)}=${encodeURIComponent(oauthParams[key])}`
  ).join("&");

  const baseString = [method, encodeURIComponent(apiUrl), encodeURIComponent(baseParams)].join("&");
  const signingKey = `${encodeURIComponent(consumerSecret)}&${encodeURIComponent(accessSecret)}`;

  // GASの標準機能で署名を生成
  const signatureBytes = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_SHA_1,
    baseString,
    signingKey
  );
  
  // 署名をBase64形式にエンコード
  const signature = Utilities.base64Encode(signatureBytes);

  oauthParams.oauth_signature = signature;

  const authHeader = "OAuth " + Object.keys(oauthParams).sort().map(key => 
    `${encodeURIComponent(key)}="${encodeURIComponent(oauthParams[key])}"`
  ).join(", ");

  const payload = JSON.stringify({ text: tweetText });

  try {
    const res = UrlFetchApp.fetch(apiUrl, {
      method: "POST",
      contentType: "application/json",
      payload: payload,
      muteHttpExceptions: true,
      headers: {
        Authorization: authHeader,
      },
    });

    const code = res.getResponseCode();
    const body = res.getContentText();

    if (code === 201 || code === 200) {
      Logger.log(`✅ 投稿成功: ${tweetText}`);
      return true;
    } else {
      Logger.log(`❌ 投稿失敗 (${code}): ${body}`);
      return false;
    }
  } catch (e) {
    Logger.log(`致命的なエラー: ${e}`);
    return false;
  }
}

/**
 * X（旧Twitter）の特殊な文字数カウントを、より正確に計算する新バージョンの関数
 * @param {string} text 文字数を計算したいテキスト
 * @return {number} Twitterルールで計算した文字数
 * @customfunction
 */
function TWITTER_LEN(text) {
  if (typeof text !== "string" || text === "") {
    return 0;
  }

  // Twitterの文字数制限は280
  const TWEET_MAX_LENGTH = 280;
  // URLはt.coで短縮され、23文字としてカウントされる
  const URL_WEIGHT = 23;

  const urlRegex = /https?:\/\/[\w!?/+\-_~=;.,*&@#$%\(\)\'\[\]]+/g;
  
  // URLを特殊な文字に置き換えて、後でカウントできるようにする
  const textForCounting = text.replace(urlRegex, " ");

  let weightedLength = 0;
  // テキストの各文字をループ
  for (const char of textForCounting) {
    // Unicodeの正規化（特定の絵文字などを正しくカウントするため）
    const normalizedChar = char.normalize("NFC");
    const charCode = normalizedChar.charCodeAt(0);

    // 特定の範囲の文字（日本語、全角記号など）を2文字としてカウント
    if (
      (charCode >= 0x2000 && charCode <= 0x2e7f) || // 一般的な句読点、記号
      (charCode >= 0x3000 && charCode <= 0x30ff) || // CJKの記号、句読点、ひらがな、カタカナ
      (charCode >= 0x4e00 && charCode <= 0x9fff) || // CJK統合漢字
      (charCode >= 0xac00 && charCode <= 0xd7af) || // ハングル音節
      (charCode >= 0xff00 && charCode <= 0xffef)   // 半角・全角形
    ) {
      weightedLength += 2;
    } else {
      weightedLength += 1;
    }
  }

  // URLの文字数を加算
  const urls = text.match(urlRegex);
  if (urls) {
    weightedLength += urls.length * URL_WEIGHT;
  }
  
  return weightedLength;
}