pullrequests リソース 1.0

お困りですか?

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

コミュニティに質問

Bitbucket Cloud v1 API は廃止予定です

Bitbucket Cloud REST API バージョン 1 は 2018 年 6 月 30 日に廃止予定です。すべての 1.0 API は、2019 年 4 月 29 日に、REST API から完全に削除されます。廃止についての告知をご確認ください。また、バージョン 2.0 の REST API ドキュメントをご確認ください。

概要

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

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

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

フィールド 説明
pull_request_id リクエストの ID を表す整数。これは Bitbucket によって作成されます。
comment_id コメントの ID を表す整数。これは Bitbucket によって作成されます。
parent_id コメントの ID を表す整数。これは Bitbucket によって作成されます。
utc_last_updated コメントの最終更新時刻の Universal Timestamp Coordinate (UTC: 協定世界時刻) タイムスタンプ。
filename_hash 現在使用されていません。
base_rev チェンジセットが発生したリビジョン。
filename 新しいコメントが言及しているファイル名。
content コメントのコンテンツ。
content_rendered HTML や他の書式を含むコンテンツ。
author_info コメントを追加したユーザーのアカウント プロファイル。Bitbucket アカウントの保持者のみがリクエストにコメントを追加できます。
line_from コメントの開始行。
line_to コメントの終了行。
dest_rev 宛先のソースを示すリビジョン。
utc_created_on コメント作成時の Universal Timestamp Coordinate (UTC: 協定世界時刻) タイムスタンプ。
anchor 現在使用されていません。
is_spam A boolean indicating if the request is spam or not. The Bitbucket service uses Akismet to protect its users from spam. When Akismet indicates a comment may be spam, Bitbucket sets is_spam to 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
}

新しいコメントの投稿

Creates a new comment on an request using the specified content data. The caller must be authenticated and have access to the repository to create an request. 

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
}

コメントの更新

Updates a comment on an request using the specified content data. The caller must be authenticated as a user that created the comment or as a user with administrative rights on the repository.

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
}

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

Delete the comment with the corresponding comment_id. The caller must be authenticated as a user that created the comment or as a user with administrative rights on the repository.


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 が返されます。

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

Toggles the spam flag on a pull request comment identified by the pull_request_id. This call requires authentication. This call takes the following parameters:

パラメータ 必須かどうか 説明
accountname はい リポジトリを所有しているチームまたは個人アカウント。
repo_slug はい リポジトリ ID。
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.