> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 今後のAPI変更

> 統合に影響する可能性のあるAPIの変更

APIに対する以下の変更は、指定された日付から有効になります。
互換性を破る可能性のある変更については慎重にご確認ください。
すべての新機能については、[What's New](/whatsnew/latest)をご覧ください。

<Update label="June 15, 2026">
  <ul class="custom-bullets">
    <li>
      **Facebook: Metaがユニークインプレッション(リーチ)および3秒動画視聴のInsights指標を廃止しました。** MetaはすべてのGraph APIバージョンでこれらの指標を削除したため、影響を受けるフィールドは返却されなくなりました。詳細については、[Meta Graph API v25 changelog](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/)をご覧ください。

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post)は、以下のFacebookフィールドを返却しなくなりました:

          <ul class="custom-bullets">
            <li>impressionsUnique → `mediaView`に移行</li>
            <li>impressionsFanUnique → `mediaView`に移行</li>
            <li>impressionsOrganicUnique → `mediaView`に移行</li>
            <li>impressionsPaidUnique → `mediaViewIsFromAds`に移行</li>
            <li>videoViewsUnique → 非ユニーク3秒視聴には`videoViews`を使用</li>
            <li>`totalVideoViews*Unique`および`totalVideoImpressions*`ファミリー(例: `totalVideoViewsOrganicUnique`、`totalVideoViewsPaidUnique`、`totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social)は、以下のFacebookフィールドを返却しなくなりました:

          <ul class="custom-bullets">
            <li>`pagePostsImpressions*`ファミリー(`pagePostsImpressions`、`pagePostsImpressionsPaid`、`pagePostsImpressionsUnique`、`pagePostsImpressionsOrganicUnique`、`pagePostsImpressionsViral*`、`pagePostsImpressionsNonviral*`) → `pageMediaView`に移行</li>
            <li>pagePostsServedImpressionsOrganicUnique → `pageMediaView`に移行</li>
            <li>pageVideoViewsUnique → 非ユニーク3秒視聴には`pageVideoViews`を使用</li>
          </ul>
        </li>

        <li>
          リーチには`mediaView` / `pageMediaView`を使用してください。Total Unique Media Viewsの後継指標が計画されています。`reactionsByType`、`videoViews`、`mediaView`、`pagePostEngagements`、`pageVideoViews`、`pageVideoViewsPaid`など、引き続きサポートされるフィールドは影響を受けません。
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="May 11, 2026">
  <ul class="custom-bullets">
    <li>
      **YouTubeの一時的な障害はHTTP 500ではなくHTTP 503/504を返すようになりました:** これまでHTTP 500(`code: 176`)として現れていた一部のYouTubeアップロード失敗は、HTTP 503(`code: 454`)またはHTTP 504(`code: 453`)を返すようになりました。両レスポンスには`retryAvailable: true`が含まれます。HTTP 500でフィルタしてYouTubeアップロードをリトライしていた顧客の統合は、レスポンスボディの`retryAvailable`フィールドでフィルタする方式に切り替えてください。詳細については、[エラーコード](/errors/errors-ayrshare)をご覧ください。
    </li>
  </ul>
</Update>

<Update label="April 9, 2026">
  <ul class="custom-bullets">
    <li>
      **空の分析でエラー187を返します:** プラットフォームからデータが返されない場合、[ソーシャル分析](/apis/analytics/social)または[投稿分析](/apis/analytics/post)をリクエストすると、以前の`{ "status": "success" }`ではなく`{ "status": "error", "code": 187 }`が返されるようになりました。以前の空成功動作に依存しているクライアントコードは更新してください。
    </li>
  </ul>
</Update>

<Update label="March 31, 2026">
  <ul class="custom-bullets">
    <li>
      **X/Twitter BYOキー要件:** Ayrshare経由のX/Twitter操作すべてで、独自のAPI認証情報が必要になります。OAuth経由でXアカウントを連携した後、すべてのX/Twitterリクエストに`X-Twitter-OAuth1-Api-Key`と`X-Twitter-OAuth1-Api-Secret`の2つのヘッダーを含めてください。有効な認証情報のないリクエストは拒否されます。手順については、[X BYOキー設定ガイド](/dashboard/connect-social-accounts/x-twitter-byo-keys)をご覧ください。
    </li>

    <li>
      **RSS-to-Xは非推奨になります:** RSS自動投稿のX/Twitterサポートは2026年3月31日以降廃止されます。RSSフィードはリクエストごとの認証情報なしでスケジュール実行されるため、BYOキーモデルと互換性がありません。他のプラットフォームへのRSS自動投稿は影響を受けません。
    </li>

    <li>
      **X Account Activity Webhookは非推奨になります:** X Account Activity webhookアクション(`accountActivity`)は2026年3月31日以降利用できなくなります。これには、連携されたXアカウントに対するすべてのリアルタイムイベント通知(投稿、メンション、DM、いいね、フォロー、ブロックなど)が含まれます。
    </li>
  </ul>
</Update>

<Update label="November 14, 2025">
  <ul class="custom-bullets">
    <li>
      2025年11月14日より、Facebookは[GET analytics/social](/apis/analytics/social)で以下のフィールドを非推奨にします:

      <ul class="custom-bullets">
        <li>pageFans</li>
        <li>pageFansCity</li>
        <li>pageFansLocale</li>
        <li>pageFansCountry</li>
        <li>pageFansAdds</li>
        <li>pageFanAddsUnique</li>
        <li>pageFanRemoves</li>
        <li>pageFanRemovesUnique</li>
        <li>pageImpressions → `pageMediaView`に移行</li>
        <li>pageImpressionsPaidUnique → `pageMediaViewIsFromAds`に移行</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → `pageMediaViewIsFromAds`に移行</li>
      </ul>
    </li>

    <li>
      2025年11月14日より、Facebookは[GET analytics/post](/apis/analytics/post)で以下のフィールドを非推奨にします:

      <ul class="custom-bullets">
        <li>impressionsおよびimpressionsFanPaidUnique → `mediaView`に移行。細分化された内訳は`mediaViewIsFromAds`(広告帰属視聴)と`mediaViewIsFromFollowers`(フォロワー帰属視聴)で利用可能。</li>
        <li>postImpressionsUnique(Reels) → リール再生回数には`blueReelsPlayCount`を、視聴時間の合計には`postVideoViewTime`を使用してください。</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="September 1, 2025">
  <ul class="custom-bullets">
    <li>
      2025年9月1日より、Instagramの[コメント取得](/apis/comments/get-comments)エンドポイントは返信オブジェクトの`text`フィールドを含まなくなります。返信内容にアクセスするには、代わりに`comment`フィールドを使用してください。
    </li>
  </ul>
</Update>

<Update label="June 1, 2025">
  <ul class="custom-bullets">
    <li>
      X (Twitter)の[コメント取得](/apis/comments/get-comments)エンドポイントは、ユーザーの公開指標を新しい`publicMetrics`オブジェクトに移動します。以下のフィールドはトップレベルから`publicMetrics`オブジェクトに移動されます:

      <ul class="custom-bullets">
        <li>followersCount</li>
        <li>followingCount</li>
        <li>tweetCount</li>
        <li>listedCount</li>
        <li>mediaCount</li>
      </ul>
    </li>

    <li>
      Facebookは[GET analytics/social](/apis/analytics/social)で以下のフィールドを非推奨にします:

      <ul class="custom-bullets">
        <li>pageVideoViews10S</li>
        <li>pageVideoViews10SAutoplayed</li>
        <li>pageVideoViews10SClickToPlay</li>
        <li>pageVideoViews10SOrganic</li>
        <li>pageVideoViews10SPaid</li>
        <li>pageVideoViews10SRepeat</li>
        <li>pageVideoViews10SUnique</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="May 7, 2025">
  <ul class="custom-bullets">
    <li>
      YouTubeは、許可およびブロックされた地域の設定を非推奨にしました。postエンドポイントに引き続き許可およびブロック地域を追加できますが、無視されます。
    </li>
  </ul>
</Update>

<Update label="April 20, 2025">
  <ul class="custom-bullets">
    <li>
      [Instagram投稿分析](/apis/analytics/post)の以下の指標は非推奨になります:

      REELS:

      <ul class="custom-bullets">
        <li>
          playsCount
        </li>

        <li>
          clipsReplaysCount
        </li>

        <li>
          igReelsAggregatedAllPlaysCount
        </li>
      </ul>

      FEED/STORY:

      <ul class="custom-bullets">
        <li>
          impressionsCount
        </li>
      </ul>
    </li>

    <li>
      [historyエンドポイント](/apis/history/get-history)は、`limit`がデフォルトの25より大きい場合、1分間のキャッシュを強制します。
    </li>
  </ul>
</Update>

<Update label="March 1, 2025">
  TikTokの[コメント取得](/apis/comments/get-comments)エンドポイントは、他のソーシャルネットワークに合わせてフィールド名を標準化します。

  <ul class="custom-bullets">
    <li>
      `replyList`フィールドは`replies`に、`profileImage`は`profileImageUrl`に名前が変更されます。
    </li>

    <li>両方の新しいフィールド名はすでに利用可能で、統合で使用できます。</li>

    <li>
      TikTokには以下の更新があります:

      <ul class="custom-bullets">
        <li>
          [ソーシャル分析](/apis/analytics/social)エンドポイント: 以下の変更が予定されています: •
          `durationAverage`フィールドは非推奨となり削除されます。• TikTok APIの制限により、`shareCountTotal`、`viewCountTotal`、`commentCountTotal`フィールドは、全期間の合計ではなく過去60日間の合計のみを返すようになります。• 60日間の合計を今すぐ使用するには、APIリクエストボディに`period60Days: true`を追加してください。注意: このパラメータを使用すると、レスポンス時間が大幅に改善されます。
        </li>

        <li>
          [履歴プラットフォーム](/apis/history/history-platform)および[投稿分析](/apis/analytics/post)エンドポイント: 未文書化のフィールド`caption`、`comments`、`shares`、`likes`、`shareUrl`、`itemsId`は削除されます。代わりに`post`、`commentsCount`、`sharesCount`、`likesCount`、`postUrl`、`id`フィールドを使用してください。
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="February 1, 2025">
  [/user](/apis/user/profile-details)エンドポイントはAPI使用量の報告方法を変更します:

  <ul class="custom-bullets">
    <li>
      `monthlyApiCalls`フィールドは、すべてのAPI呼び出し(投稿、コメント、分析など)をカウントするように拡張されます。
    </li>

    <li>投稿固有のカウントには、新しい`monthlyPostCount`フィールドを使用してください。</li>

    <li>
      `monthlyApiCallsQuota`フィールドは非推奨となり、新しい`monthlyPostQuota`フィールドに置き換えられます。
    </li>
  </ul>
</Update>

<Update label="January 5, 2025">
  <ul class="custom-bullets">
    <li>
      MetaはInstagramの[投稿分析エンドポイント](/apis/analytics/post)における`videoViews`フィールドを非推奨にします。
    </li>

    <li>
      さらに、Instagramの[ソーシャル分析](/apis/analytics/social)エンドポイントから、`emailContactsCount`、`getDirectionClicks`、`profileViewsCount`、`textMessageClicks`、`websiteClicksCount`、および`phoneCallClicksCount`フィールドが削除されます。
    </li>

    <li>これらのフィールドは2025年1月5日に削除されます。</li>
  </ul>
</Update>

<Update label="December 15, 2024">
  <ul class="custom-bullets">
    <li>
      セキュリティ強化のため、Profile KeyがAPI Keyとして使用されないようにします。API Keyの代わりにProfile Keyを使用しようとすると、システムがエラーを返します。Profile Keyの正しい使用方法については、[こちら](/apis/overview#authorization)をご覧ください。
    </li>
  </ul>
</Update>

<Update label="November 15, 2024">
  <ul class="custom-bullets">
    <li>
      TikTokスケジュール済みwebhookのエラー報告方法を更新しました。これらのエラーは、他のスケジュール済みwebhookタイプのエラー処理と同様、errors配列に表示されるようになりました。なお、現在のトップレベルエラーは引き続き返されますが、errors配列の使用を推奨します。
    </li>

    <li>
      historyエンドポイントは、デフォルトでレスポンスをオブジェクトとして返すようになりました。objResponseパラメータは自動的にtrueに設定されます。
    </li>

    <li>
      Get All History LinkedInは、mediaUrlsオブジェクトを配列として返します。以前は、メディア項目が1つだけの場合はオブジェクトを、複数のメディア項目の場合は配列を返していました。現在は、メディア項目が1つだけの場合でも常に配列が返されます。以前の動作が必要な場合は、`objResponse: false`クエリパラメータを使用できます。
    </li>
  </ul>
</Update>

<Update label="October 7, 2024">
  <ul class="custom-bullets">
    <li>
      mediaエンドポイントはurl\_1080を返さなくなります。画像のリサイズが必要な場合は、[resizeエンドポイント](/apis/media/resize)をご覧ください。
    </li>
  </ul>
</Update>

<Update label="September 16, 2024">
  <ul class="custom-bullets">
    <li>
      **2024年9月25日更新**: Meta(Facebook)がフィールドの非推奨をリリースしたため、フィールドの削除が有効になっています。[ソーシャル分析](/apis/analytics/social)で更新された返り値をご確認ください。
    </li>

    <li>
      Facebookは[いくつかのフィールドを非推奨にします](https://developers.facebook.com/docs/pages-api/changelog/)。[ソーシャル分析エンドポイント](/apis/analytics/social-by-id)は、2024年9月16日以降、これらのフィールドを返しません。
    </li>
  </ul>
</Update>

<Update label="June 3, 2024">
  <ul class="custom-bullets">
    <li>
      [新しいリンク短縮](/apis/links/overview)システムが、Googleによって非推奨とされた短縮エンドポイントを置き換えます。新しいリンク短縮ツールには、アドオンの[Max Pack](/additional/maxpack)が必要です。
    </li>

    <li>
      リンク短縮はデフォルトでオフ(`false`)になります。リンクを自動的に短縮するには、postエンドポイント呼び出しで`shortenLinks: true`を使用してください。これは新しい[linkエンドポイント](/apis/links/overview)を使用します。
    </li>
  </ul>
</Update>

<Update label="April 22, 2024">
  <ul class="custom-bullets">
    <li>
      MetaはFacebook Groups APIを非推奨にします。[お知らせ](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/)をご覧ください。
    </li>
  </ul>
</Update>

<Update label="April 16, 2024">
  <ul class="custom-bullets">
    <li>
      Instagramは、オンラインフォロワーデータセットの期間を明確化しました。[詳細](/apis/analytics/instagram-follower-count)については、こちらをご覧ください。
    </li>
  </ul>
</Update>

<Update label="April 1, 2024">
  <ul class="custom-bullets">
    <li>
      [コメントIDを使用したコメントへの返信](/apis/comments/reply-to-comment)のデフォルトレスポンスは、配列ではなくドキュメントに記載されているオブジェクトになります。配列レスポンスを維持したい場合は、objResponseパラメータをboolean `false`に設定できます。
    </li>
  </ul>
</Update>

<Update label="January 25, 2024">
  <ul class="custom-bullets">
    <li>
      [retry postエンドポイント](/apis/post/retry-post)は、リトライのステータスをより正確に反映するため、「success」の代わりに「pending」ステータスを返します。
    </li>

    <li>
      [scheduleDateおよびcreateDateに関するAPI変更](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022)がリリースされます。
    </li>
  </ul>
</Update>

<Update label="December 8, 2023">
  <ul class="custom-bullets">
    <li>
      `/history/instagram`エンドポイントの`caption`、`message`、`createdTime`、`timestamp`フィールドは2023年4月1日に非推奨となり、削除されます。`post`および`created`フィールドを使用してください。
    </li>

    <li>
      `/history/linkedin`エンドポイントの`mediaUrls`フィールドは、複数の画像をサポートするため、オブジェクトではなく配列として返されます。LinkedInクエリパラメータ`?multiMedia=true`を含めることで、現在も配列を返すよう強制できます。なお、2023年12月1日より前は、複数の画像を含むメディアを返すには`multiMedia`クエリパラメータを使用する必要があります。2023年12月1日以降は、デフォルトで複数の画像が返されるようになります。
    </li>

    <li>
      Scheduled Action TikTok webhookは、文字列型の`platform`が非推奨になります。他のScheduled Action webhookと同様に、`platforms`配列フィールドを使用してください。
    </li>

    <li>delete commentドキュメントは、正しい返り値に合わせて修正されました。</li>

    <li>
      TikTokのcommentIdフィールドは、標準のコメント削除形式に合わせるため、idフィールドに置き換えられます。
    </li>

    <li>
      Twitterのdelete commentの返り値は、`posts`配列を含まなくなり、標準のコメント削除形式に沿った返り値になります。新しい返り値は次のとおりです:
    </li>
  </ul>
</Update>

<Update label="October 18, 2023">
  <ul class="custom-bullets">
    <li>
      [ソーシャル分析エンドポイント](/apis/analytics/social)の以下のYouTubeフィールドは、文字列値ではなく数値として返されます。
    </li>
  </ul>
</Update>

<Update label="May 30, 2023">
  <ul class="custom-bullets">
    <li>
      Twitterの新しいAPIバージョン2にアップグレードしました。Twitterはバージョン2でいくつかのフィールドを非推奨にしました。これは/analytics/socialおよびgetAllHistoryエンドポイントに影響します。これらのフィールドは2023年9月1日まで引き続き返されますが、ゼロまたは空文字列の値になります。
    </li>
  </ul>
</Update>

<Update label="May 8, 2023">
  <ul class="custom-bullets">
    <li>
      [TikTokの直接公開](/apis/post/social-networks/tiktok)、コメント管理、および高度な分析をリリースいたします。ユーザーは、投稿してキャプションテキストを入力するためにTikTokモバイルアプリを開く必要がなくなります。Ayrshare経由で送信した後、TikTok動画とキャプションが直接公開されます。
    </li>

    <li>
      TikTokコメントの追加、取得、削除、およびデモグラフィック分析データも導入します。
    </li>

    <li>
      直接公開を有効にするには、ユーザーはTikTokアカウントの連携を解除し、再連携する必要があります。既存の接続は、間接的な方法で継続し、公開にはTikTokモバイルアプリが必要です。
    </li>
  </ul>
</Update>

<Update label="February 17, 2023">
  <ul class="custom-bullets">
    <li>
      Google Business Profileは、利用可能なソーシャル分析データを変更しました。新しい利用可能なフィールドは以下のとおりです。以前のフィールドは引き続き存在しますが、値はゼロとなり、2023年3月17日に完全に削除されます。
    </li>
  </ul>
</Update>

<Update label="October 1, 2022">
  <ul class="custom-bullets">
    <li>Get All Postsのdescriptions、text、messageフィールドは`post`フィールドに標準化されました。</li>
  </ul>
</Update>

<Update label="September 12, 2022">
  <ul class="custom-bullets">
    <li>TikTokフィールドが非推奨: `shareUrl`。代わりに`postUrl`を使用してください。</li>
  </ul>
</Update>

<Update label="June 17, 2022">
  <ul class="custom-bullets">
    <li>
      すべてのhistoryエンドポイントで、`createdAt`、`createdTime`、`timestamp`フィールドは、UTC形式で作成時刻を返す`created`フィールドに置き換えられます。
    </li>

    <li>
      `scheduleDate`フィールドは、UTC形式でスケジュール時刻を含む文字列によってオブジェクトを返さなくなります。
    </li>

    <li>
      /historyの未文書化`created_date`フィールドは削除されます。代わりに`created`を使用してください。
    </li>
  </ul>
</Update>

<Update label="April 22, 2022">
  <ul class="custom-bullets">
    <li>
      [Facebook投稿](/apis/analytics/post)の分析は、`reactions`を以下の形式のオブジェクトとして返します。
    </li>
  </ul>
</Update>

<Update label="April 1, 2022">
  <ul class="custom-bullets">
    <li>
      historyはデフォルトで最新20件の投稿を返します。`lastRecords`パラメータで最大500件を返却できます。
    </li>
  </ul>
</Update>