pullrequests リソース 1.0

お困りですか?

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

コミュニティに質問

Bitbucket Cloud v1 API は廃止予定です

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 12 April 2019. 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.
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 はい The pull_request_id changeset identifier.
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.