Trellodotnetassistant

TrelloDotNet

TrelloDotNetへようこそ。Trello REST APIの.NET実装です。

機能

• Trelloの機能に対するCRUD操作を行うTrelloClient
• Webhookイベントを処理するためのAutomation EngineとWebhook Data Receiver

はじめに

以下の手順に従うか、TrelloDotNet MCP サーバーを使ってAIに支援してもらい、全体をVibe Codeできます。 8-)

1. 'TrelloDotNet' NuGetパッケージをインストールします（dotnet add package TrelloDotNet）
2. Power-Ups AdministrationからAPIキーとトークンを取得します
3. 新しいTrelloClientのインスタンスを作成します（名前空間'TrelloDotNet'内にあります）
4. ボード、リスト、カードのIDを確認します（こちらの動画、またはこのREADMEの末尾を参照してください）
5. 以下の例や[Wiki](https://github.com/rwjdk/trello-dotnet/

使用例：

TrelloClient client = new TrelloDotNet.TrelloClient("APIKEY", "TOKEN"); //IMPORTANT: Remember to NOT leave Key and Token in clear text!

//Get all boards that the Token Owner can access
List<Board> boards = await client.GetBoardsCurrentTokenCanAccessAsync();

//Get a specific board
Board board = await client.GetBoardAsync("<boardId>");

//Get lists on a board
List<List> lists = await client.GetListsOnBoardAsync("<boardId>");

//Get cards on a board
List<Card> cardsOnBoard = await client.GetCardsOnBoardAsync("<boardId>");

//Get cards in a specific list
List<Card> cardsInList = await client.GetCardsInListAsync("<listId>");

//Get a specific card
Card card = await client.GetCardAsync("<cardId>");

//Add a card (simple)
AddCardOptions newCardOptions = new AddCardOptions("<listId>", "My Card", "My Card description");
Card newCard = await client.AddCardAsync(newCardOptions);

//Add a card (advanced, with all options set)
Card newAdvancedCard = await client.AddCardAsync(new AddCardOptions
{
    //Required options
    ListId = "<listId>",
    Name = "My Card",

    //Optional options
    Description = "Description of My Card",
    Start = DateTimeOffset.Now,
    Due = DateTimeOffset.Now.AddDays(3),
    Cover = new CardCover(CardCoverColor.Blue, CardCoverSize.Normal),
    LabelIds = new List<string>
    {
        "<labelId1>",
        "<labelId2>",
    },
    MemberIds = new List<string>
    {
        "<memberId1>",
        "<memberId2>"
    },
    Checklists = new List<Checklist>
    {
        new Checklist("Checklist 1", new List<ChecklistItem>
        {
            new ChecklistItem("Item 1"),
            new ChecklistItem("Item 2"),
            new ChecklistItem("Item 3")
        }),
        new Checklist("Checklist 2", new List<ChecklistItem>
        {
            new ChecklistItem("Item A"),
            new ChecklistItem("Item B"),
            new ChecklistItem("Item C")
        }),
    },
    AttachmentUrlLinks = new List<AttachmentUrlLink>
    {
        new AttachmentUrlLink("https://www.google.com", "Google")
    },
    AttachmentFileUploads = new List<AttachmentFileUpload>
    {
        new AttachmentFileUpload(File.OpenRead(@"<pathToFile>"), "<Filename>", "<FileDescription>")
    },
    CustomFields = new List<AddCardOptionsCustomField>
    {
        new AddCardOptionsCustomField(customField1OnBoard, "ABC"),
        new AddCardOptionsCustomField(customField2OnBoard, 123),
    }
});

//Update a card (with new name and description and removal of Due Date)
var updateCard = await client.UpdateCardAsync("<cardId>", [
    CardUpdate.Name("New Name"),
    CardUpdate.Description("New Description"),
    CardUpdate.DueDate(null),
]);

//Add a checklist to a card
var checklistItems = new List<ChecklistItem>
{
    new("ItemA"),
    new("ItemB"),
    new("ItemC")
};
Checklist newChecklist = new Checklist("Sample Checklist", checklistItems);
Checklist addedChecklist = await client.AddChecklistAsync("<cardId>", newChecklist);

動画ガイド

• Trello Developer Fundamentals
  • APIキーとトークンの取得方法
  • Trelloボード上のIDの見つけ方
• TrelloDotNet
  • TrelloDotNet NuGetパッケージの使い方
  • Eラーニングのプレイリスト
  • Webhook
    • Webhookの扱い方（パート1：セットアップ）
    • Webhookの扱い方（パート2：イベントの受信）

便利なリンク

• Udemy コース
• Wiki
• 変更履歴
  • バージョン 2.0 移行ガイド
• 問題を報告
• セキュリティに関する懸念を報告
• TrelloDotNet NuGet パッケージ
• 開発者向け LinkedIn グループ
• ID を特定する Power-Up
• Trello API YouTube プレイリスト
• API キーとトークンの Power-Ups 管理センター
• Trello API ドキュメント
• Trello 変更履歴
• 最初の Power-Up の作成方法

Trello から ID を取得する方法

Trello で ID を取得する最も簡単な方法は、この Power-Up を使ってコピー／貼り付けすることです（推奨）。

または、プロジェクト内の共有ボタンを使用します（Power-Up は不要ですが、少し手間がかかります）。

エクスポート結果は次のようになります（ID を検索するか、ツールを使って JSON を整形すると見やすくなります）。

お楽しみください！