emails リソース

このページの内容

お困りですか?

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

コミュニティに質問

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.

概要

1 つのアカウントはに 1 つ以上のメール アドレスを関連付けることができます。メール アドレスを一覧表示、変更、または作成するには、このエンドポイントを使用します。このリソースには以下のフィールドがあります。

フィールド 説明
active Boolean indicating the user confirmed the email address (true). While this flag is false, Bitbucket does not use the email address to do such things as linking changesets back to an account.
email メール アドレス。
primary Boolean indicating the email is the primary (true). The primary address is the main contact email address for the account. If an account has multiple email addresses, only one address can be primary.

ユーザーのメール アドレスの一覧の GET

アカウントに関連付けられたメール アドレスを取得します。この呼び出しには認証が必要です。個人アカウントとチーム アカウントで返されるフィールド候補は同じです。この呼び出しでは、次のパラメーターを使用します。

パラメーター 必須 説明
accountname はい 個人またはチーム アカウントの名前。
GET https://api.bitbucket.org/1.0/users/{accountname}/emails
ここをクリックして展開...
[
    {
        "active": true,
        "email": "2team.bb@gmail.com",
        "primary": true
    },
    {
        "active": false,
        "email": "ourteam@gmail.com",
        "primary": false
    }
]

メール アドレスの GET

アカウントに関連付けられた個々のメール アドレスを取得します。この呼び出しには認証が必要です。この呼び出しでは、次のパラメーターを使用します。

パラメーター 必須 説明
accountname はい 個人またはチーム アカウントの名前。
email_address はい 取得するメール アドレス。
GET https://api.bitbucket.org/1.0/users/{accountname}/emails/{email_address}
ここをクリックして展開...
{
        "active": false,
        "email": "ourteam@gmail.com",
        "primary": false
}

新しいメール アドレスの POST

アカウントにメール アドレスを追加します。この呼び出しには認証が必要です。アカウントに複数のメール アドレスがある場合、以下の PUT コールを使用して、アドレスの 1 つをプライマリに設定することができます。この呼び出しでは、次のパラメーターを使用します。

パラメーター 必須 説明
accountname はい 個人またはチーム アカウントの名前。
email_address はい 取得するメール アドレス。

When you add an address, Bitbucket sends an activation email to the new address. After the user clicks the activation link in the email, the address active is set to true and the address is available for use. If you make the POST call again, Bitbucket sends a new confirmation email with a new and sets the active value to false. The newly sent activation link supersedes the link in any previous emails.

キャッシュにより、サイト上のすべての関連ページで新しいアドレスの反映に時間がかかる場合があります。

POST https://api.bitbucket.org/1.0/users/{accountname}/emails/{email_address} --data"email=value"
ここをクリックして展開...
[
    {
        "active": true,
        "email": "2team.bb@gmail.com",
        "primary": true
    },
    {
        "active": false,
        "email": "ourteam@gmail.com",
        "primary": false
    }
]

メール アドレスの更新

アカウントに関連付けられた 1 つのメール アドレスをプライマリに設定します。プライマリ メール アドレスは、そのアカウントのメインの連絡先となります。アカウントでは 1 つのアドレスのみをプライマリにすることができます。このコールに先立ってほかのアドレスがプライマリに設定されていた場合、そのアドレスはコール以降はプライマリではなくなります。この呼び出しには認証が必要であり、次のパラメーターを使用します。

パラメーター 必須 説明
accountname はい 個人またはチーム アカウントの名前。
email_address はい 取得するメール アドレス。
PUT https://api.bitbucket.org/1.0/users/{accountname}/emails/{email_address} --data "primary=true"
ここをクリックして展開...
{
        "active": true,
        "email": "ourteam@gmail.com",
        "primary": true
}
最終更新日 2018 年 6 月 14 日

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

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