pullrequests リソース 1.0

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Bitbucket Cloud v1 APIs are deprecated

Bitbucket Cloud REST API version 1 is deprecated effective 30 June 2018. All 1.0 APIs will be removed from the REST API permanently on 31 December 2018. Read the deprecation notice. Or you can jump right to the version 2.0 REST API documentation.

概要

プル リクエストのコメントを管理します。ほかのユーザーがコメントに返信することで、コメントのスレッドを作成できます。 

プル リクエストのコメント一覧の取得廃止予定

特定のリクエストのコメントを配列形式で取得します。リクエストのコメントには次のフィールドがあります。

フィールド 説明
pull_request_id リクエストの ID を表す整数。これは Bitbucket によって作成されます。
comment_id An integer representing an id for the comment. This is created by Bitbucket.
parent_id コメントの ID を表す整数。これは Bitbucket によって作成されます。
utc_last_updated A Universal Timestamp Coordinate timestamp for the last time the comment was updated.
filename_hash 現在使用されていません。
base_rev チェンジセットが発生したリビジョン。
filename 新しいコメントが言及しているファイル名。
content The content of the comment.
content_rendered HTML や他の書式を含むコンテンツ。
author_info コメントを追加したユーザーのアカウント プロファイル。Bitbucket アカウントの保持者のみがリクエストにコメントを追加できます。
line_from コメントの開始行。
line_to コメントの終了行。
dest_rev 宛先のソースを示すリビジョン。
utc_created_on A Universal Timestamp Coordinate timestamp for the comment creation.
アンカー 現在使用されていません。
is_spam リクエストがスパムかどうかを示すブール値。Bitbucket サービスは Akismet を使用してユーザーをスパムから保護します。Akismet によりコメントがスパムの可能性があると示されると、Bitbucket は is_spam を true に設定します。

非公開リポジトリの場合、リポジトリを参照するには、呼び出し元が権限を持つユーザーとして認証する必要があります。

GET https://api.bitbucket.org/1.0/repositories/{accountname}/{repo_slug}/pullrequests/{pull_request_id}/comments
ここをクリックして展開...
[
    {
        "pull_request_id": 672,
        "comment_id": 14352,
        "parent_id": null,
        "deleted": false,
        "utc_last_updated": "2012-08-12 18:48:01+00:00",
        "filename_hash": null,
        "base_rev": "174eecac678c",
        "filename": null,
        "content": "I can't pull from a deleted repository.I'll have to delete this request.Thank you for working through t
he tutorial.",
"content_rendered": "<p>I can't pull from a deleted repository.I'll have to delete this request.Thank you for worki
ng through the tutorial.</p>\n",
"author_info": {
            "username": "tutorials",
            "first_name": "",
            "last_name": "",
            "is_team": false,
            "avatar": "https://secure.gravatar.com/avatar/0bc5bd490000b8e63c35c0f54e667b9e?d=identicon&s=32",
            "resource_uri": "/1.0/users/tutorials"
},
        "line_from": null,
        "line_to": null,
        "dest_rev": "101f16a95c13",
        "utc_created_on": "2012-08-12 18:48:01+00:00",
        "anchor": "a18fd07465b5",
        "is_spam": false
    }
]

プル リクエストの特定のコメントの取得 廃止予定

リクエストの特定のコメントを取得します。非公開リポジトリの場合、適切なアクセス権を持つアカウントとして認証を行う必要があります。

GET https://api.bitbucket.org/1.0/repositories/{accountname}/{repo_slug}/pullrequests/{pull_request_id}/comments/{comment_id}
ここをクリックして展開...
{
    "pull_request_id": 672,
    "comment_id": 14353,
    "parent_id": 14352,
    "deleted": false,
    "utc_last_updated": "2012-08-12 18:54:53+00:00",
    "filename_hash": null,
    "base_rev": "174eecac678c",
    "filename": null,
    "content": "This is a reply.",
"content_rendered": "<p>This is a reply.</p>\n",
"author_info": {
        "username": "tutorials",
        "first_name": "",
        "last_name": "",
        "is_team": false,
        "avatar": "https://secure.gravatar.com/avatar/0bc5bd490000b8e63c35c0f54e667b9e?d=identicon&s=32",
        "resource_uri": "/1.0/users/tutorials"
},
    "line_from": null,
    "line_to": null,
    "dest_rev": "101f16a95c13",
    "utc_created_on": "2012-08-12 18:54:53+00:00",
    "anchor": "a18fd07465b5",
    "is_spam": false
}

新しいコメントの投稿

指定した content データを使用してリクエストに新しいコメントを作成します。リクエストを作成するには、呼び出し元が認証済みで、リポジトリへのアクセス権を持っている必要があります。 

POST https://api.bitbucket.org/1.0/repositories/{accountname}/{repo_slug}/pullrequests/{pull_request_id}/comments--data "content=string"
ここをクリックして展開...
{
    "username": "tutorials",
    "pull_request_id": 672,
    "comment_id": 14356,
    "display_name": "tutorials",
    "parent_id": null,
    "deleted": false,
    "utc_last_updated": "2012-08-12 20:04:38+00:00",
    "filename_hash": null,
    "base_rev": "174eecac678c",
    "filename": null,
    "content": "This is yet another comment",
    "content_rendered": "<p>This is yet another comment</p>\n",
    "user_avatar_url": "https://secure.gravatar.com/avatar/0bc5bd490000b8e63c35c0f54e667b9e?d=identicon&s=32",
    "line_from": null,
    "line_to": null,
    "dest_rev": "101f16a95c13",
    "utc_created_on": "2012-08-12 20:04:38+00:00",
    "anchor": "a18fd07465b5",
    "is_spam": false
}

コメントの更新

指定した content データを使用してリクエストのコメントを更新します。呼び出し元は、コメントを作成したユーザーまたはリポジトリの管理権限を持つユーザーとして認証済みである必要があります。

PUT  https://api.bitbucket.org/1.0/repositories/{accountname}/{repo_slug}/pullrequests/{pull_request_id}/comments/{comment_id}--data "content=string"
ここをクリックして展開...
{
    "username": "tutorials",
    "pull_request_id": 672,
    "comment_id": 14356,
    "display_name": "tutorials",
    "parent_id": null,
    "deleted": false,
    "utc_last_updated": "2012-08-12 20:04:38+00:00",
    "filename_hash": null,
    "base_rev": "174eecac678c",
    "filename": null,
    "content": "This is an update to my comment.",
"content_rendered": "<p>This is an update to my comment.</p>\n",
"user_avatar_url": "https://secure.gravatar.com/avatar/0bc5bd490000b8e63c35c0f54e667b9e?d=identicon&s=32",
    "line_from": null,
    "line_to": null,
    "dest_rev": "101f16a95c13",
    "utc_created_on": "2012-08-12 20:04:38+00:00",
    "anchor": "a18fd07465b5",
    "is_spam": false
}

プル リクエストのコメントの削除

対応する comment_id のコメントを削除します。呼び出し元は、コメントを作成したユーザーまたはリポジトリの管理権限を持つユーザーとして認証済みである必要があります。


DELETE  https://api.bitbucket.org/1.0/repositories/{accountname}/{repo_slug}/pullrequests/{pull_request_id}/comments/{comment_id}
ここをクリックして展開...
{
    "pull_request_id": 672,
    "comment_id": 14356,
    "deleted": true,
    "filename_hash": null,
    "base_rev": "174eecac678c",
    "filename": null,
    "parent_id": null,
    "line_from": null,
    "line_to": null,
    "dest_rev": "101f16a95c13",
    "anchor": "a18fd07465b5",
    "is_spam": false
}

削除に成功すると、HTTP/1.1 200 OK が返されます。

既存のプル リクエストのコメントのスパム フラグの切り替え

pull_request_id で指定したプル リクエストのコメントのスパム フラグを切り替えます。この呼び出しには認証が必要です。この呼び出しでは、次のパラメーターを使用します。

パラメーター 必須かどうか 説明
accountname はい The team or individual account owning the repo.
repo_slug はい The repo identifier.
pull_request_id はい pull_request_id チェンジセットの識別子。
comment_id はい コメント識別子。
PUT https://api.bitbucket.org/1.0/repositories/{accountname}/{repo_slug}/pullrequests/{pull_request_id}/comments/spam/{comment_id
ここをクリックして展開...
 {
    "username": "auserbb",
    "node": "abdeaf1b2b4a",
    "comment_id": 25720,
    "display_name": "A User",
    "parent_id": 25711,
    "deleted": false,
    "utc_last_updated": "2012-07-24 21:39:12+00:00",
    "filename_hash": "36e1237b957fa2002d264c5fd031c547",
    "filename": "Readme",
    "content": "what the eff",
    "content_rendered": "<p>what the eff</p>\n",
    "user_avatar_url": "https://secure.gravatar.com/avatar/49bd0ee69e520e8bc250adb95710bbb8?d=identicon&s=32",
    "line_from": 3,
    "line_to": 6,
    "utc_created_on": "2012-07-24 21:06:33+00:00",
    "is_spam": false
}


最終更新日 2018 年 6 月 14 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.