From 93cbecf5cb7eff90b86619e48b33218b0a4c3ecb Mon Sep 17 00:00:00 2001 From: "dropbox-sdk-updater[bot]" <306210582+dropbox-sdk-updater[bot]@users.noreply.github.com> Date: Wed, 23 Sep 2026 06:05:34 +0000 Subject: [PATCH] Automated Spec Update 404afad5c508a45ea9004c9d8c0cd4a56f0fbf22 Automated update of the API specification Co-authored-by: dropbox-spec-updater[bot] <306253022+dropbox-spec-updater[bot]@users.noreply.github.com> --- .../core/v2/openid/UserInfoResult.java | 63 ++++++++++++------- .../com/dropbox/core/v2/users/Account.java | 34 +++++++--- .../dropbox/core/v2/users/BasicAccount.java | 47 +++++++++----- .../dropbox/core/v2/users/FullAccount.java | 47 +++++++++----- core/src/main/stone | 2 +- 5 files changed, 133 insertions(+), 60 deletions(-) diff --git a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/openid/UserInfoResult.java b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/openid/UserInfoResult.java index 471bce6efa..07ef8b0252 100644 --- a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/openid/UserInfoResult.java +++ b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/openid/UserInfoResult.java @@ -39,15 +39,22 @@ public class UserInfoResult { * Use {@link newBuilder} to create instances of this class without * specifying values for all optional fields. * - * @param familyName Last name of user. - * @param givenName First name of user. - * @param email Email address of user. - * @param emailVerified If user is email verified. - * @param iss Issuer of token (in this case Dropbox). Must not be {@code - * null}. + * @param familyName Last name of the user. + * @param givenName First name of the user. + * @param email The user's email address. Be aware it's possible that the + * user has since lost access to their email. Note: email is not a + * unique or stable identifier for a Dropbox account. Users can change + * their email, and emails can be reused by different accounts. Apps + * should not use email as a key for account identification; use {@link + * UserInfoResult#getSub} instead. + * @param emailVerified If the user's email address is verified. + * @param iss Issuer of the token (in this case Dropbox). Must not be + * {@code null}. * @param sub An identifier for the user. This is the Dropbox account_id, a - * string value such as dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc. Must - * not be {@code null}. + * string value such as dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc. The + * account_id is a unique and stable identifier for a Dropbox account, + * suitable for use as a key in authentication and account management. + * Must not be {@code null}. * * @throws IllegalArgumentException If any argument does not meet its * preconditions. @@ -77,7 +84,7 @@ public UserInfoResult() { } /** - * Last name of user. + * Last name of the user. * * @return value for this field, or {@code null} if not present. */ @@ -87,7 +94,7 @@ public String getFamilyName() { } /** - * First name of user. + * First name of the user. * * @return value for this field, or {@code null} if not present. */ @@ -97,7 +104,12 @@ public String getGivenName() { } /** - * Email address of user. + * The user's email address. Be aware it's possible that the user has since + * lost access to their email. Note: email is not a unique or stable + * identifier for a Dropbox account. Users can change their email, and + * emails can be reused by different accounts. Apps should not use email as + * a key for account identification; use {@link UserInfoResult#getSub} + * instead. * * @return value for this field, or {@code null} if not present. */ @@ -107,7 +119,7 @@ public String getEmail() { } /** - * If user is email verified. + * If the user's email address is verified. * * @return value for this field, or {@code null} if not present. */ @@ -117,7 +129,7 @@ public Boolean getEmailVerified() { } /** - * Issuer of token (in this case Dropbox). + * Issuer of the token (in this case Dropbox). * * @return value for this field, or {@code null} if not present. Defaults to * "". @@ -129,7 +141,9 @@ public String getIss() { /** * An identifier for the user. This is the Dropbox account_id, a string - * value such as dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc. + * value such as dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc. The account_id is + * a unique and stable identifier for a Dropbox account, suitable for use as + * a key in authentication and account management. * * @return value for this field, or {@code null} if not present. Defaults to * "". @@ -172,7 +186,7 @@ protected Builder() { /** * Set value for optional field. * - * @param familyName Last name of user. + * @param familyName Last name of the user. * * @return this builder */ @@ -184,7 +198,7 @@ public Builder withFamilyName(String familyName) { /** * Set value for optional field. * - * @param givenName First name of user. + * @param givenName First name of the user. * * @return this builder */ @@ -196,7 +210,12 @@ public Builder withGivenName(String givenName) { /** * Set value for optional field. * - * @param email Email address of user. + * @param email The user's email address. Be aware it's possible that + * the user has since lost access to their email. Note: email is not + * a unique or stable identifier for a Dropbox account. Users can + * change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link UserInfoResult#getSub} instead. * * @return this builder */ @@ -208,7 +227,7 @@ public Builder withEmail(String email) { /** * Set value for optional field. * - * @param emailVerified If user is email verified. + * @param emailVerified If the user's email address is verified. * * @return this builder */ @@ -223,7 +242,7 @@ public Builder withEmailVerified(Boolean emailVerified) { *

If left unset or set to {@code null}, defaults to {@code ""}. *

* - * @param iss Issuer of token (in this case Dropbox). Must not be + * @param iss Issuer of the token (in this case Dropbox). Must not be * {@code null}. Defaults to {@code ""} when set to {@code null}. * * @return this builder @@ -249,8 +268,10 @@ public Builder withIss(String iss) { * * @param sub An identifier for the user. This is the Dropbox * account_id, a string value such as - * dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc. Must not be {@code - * null}. Defaults to {@code ""} when set to {@code null}. + * dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc. The account_id is a + * unique and stable identifier for a Dropbox account, suitable for + * use as a key in authentication and account management. Must not + * be {@code null}. Defaults to {@code ""} when set to {@code null}. * * @return this builder * diff --git a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/Account.java b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/Account.java index 0855056b4c..f3ceac920e 100644 --- a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/Account.java +++ b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/Account.java @@ -41,13 +41,18 @@ public class Account { * The amount of detail revealed about an account depends on the user being * queried and the user making the query. * - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @param profilePhotoUrl URL for the photo representing the user, if one @@ -86,13 +91,18 @@ public Account(@Nonnull String accountId, @Nonnull Name name, @Nonnull String em * *

The default values for unset fields will be used.

* - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @@ -104,7 +114,7 @@ public Account(@Nonnull String accountId, @Nonnull Name name, @Nonnull String em } /** - * The user's unique Dropbox ID. + * The user's unique and stable Dropbox ID. * * @return value for this field, never {@code null}. */ @@ -126,7 +136,11 @@ public Name getName() { /** * The user's email address. Do not rely on this without checking the {@link * Account#getEmailVerified} field. Even then, it's possible that the user - * has since lost access to their email. + * has since lost access to their email. Note: email is not a unique or + * stable identifier for a Dropbox account. Users can change their email, + * and emails can be reused by different accounts. Apps should not use email + * as a key for account identification; use {@link Account#getAccountId} + * instead. * * @return value for this field, never {@code null}. */ diff --git a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/BasicAccount.java b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/BasicAccount.java index d74732eda0..883879be9a 100644 --- a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/BasicAccount.java +++ b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/BasicAccount.java @@ -35,13 +35,18 @@ public class BasicAccount extends Account { *

Use {@link newBuilder} to create instances of this class without * specifying values for all optional fields.

* - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @param isTeammate Whether this user is a teammate of the current user. @@ -67,13 +72,18 @@ public BasicAccount(@Nonnull String accountId, @Nonnull Name name, @Nonnull Stri * *

The default values for unset fields will be used.

* - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @param isTeammate Whether this user is a teammate of the current user. @@ -88,7 +98,7 @@ public BasicAccount(@Nonnull String accountId, @Nonnull Name name, @Nonnull Stri } /** - * The user's unique Dropbox ID. + * The user's unique and stable Dropbox ID. * * @return value for this field, never {@code null}. */ @@ -110,7 +120,11 @@ public Name getName() { /** * The user's email address. Do not rely on this without checking the {@link * Account#getEmailVerified} field. Even then, it's possible that the user - * has since lost access to their email. + * has since lost access to their email. Note: email is not a unique or + * stable identifier for a Dropbox account. Users can change their email, + * and emails can be reused by different accounts. Apps should not use email + * as a key for account identification; use {@link Account#getAccountId} + * instead. * * @return value for this field, never {@code null}. */ @@ -172,13 +186,18 @@ public String getTeamMemberId() { /** * Returns a new builder for creating an instance of this class. * - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @param isTeammate Whether this user is a teammate of the current user. diff --git a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/FullAccount.java b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/FullAccount.java index 1198198255..7ba250e04c 100644 --- a/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/FullAccount.java +++ b/core/build/generated_stone_source/main/src/com/dropbox/core/v2/users/FullAccount.java @@ -49,13 +49,18 @@ public class FullAccount extends Account { *

Use {@link newBuilder} to create instances of this class without * specifying values for all optional fields.

* - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @param locale The language that the user specified. Locale tags will be @@ -127,13 +132,18 @@ public FullAccount(@Nonnull String accountId, @Nonnull Name name, @Nonnull Strin * *

The default values for unset fields will be used.

* - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @param locale The language that the user specified. Locale tags will be @@ -160,7 +170,7 @@ public FullAccount(@Nonnull String accountId, @Nonnull Name name, @Nonnull Strin } /** - * The user's unique Dropbox ID. + * The user's unique and stable Dropbox ID. * * @return value for this field, never {@code null}. */ @@ -182,7 +192,11 @@ public Name getName() { /** * The user's email address. Do not rely on this without checking the {@link * Account#getEmailVerified} field. Even then, it's possible that the user - * has since lost access to their email. + * has since lost access to their email. Note: email is not a unique or + * stable identifier for a Dropbox account. Users can change their email, + * and emails can be reused by different accounts. Apps should not use email + * as a key for account identification; use {@link Account#getAccountId} + * instead. * * @return value for this field, never {@code null}. */ @@ -308,13 +322,18 @@ public String getTeamMemberId() { /** * Returns a new builder for creating an instance of this class. * - * @param accountId The user's unique Dropbox ID. Must have length of at - * least 40, have length of at most 40, and not be {@code null}. + * @param accountId The user's unique and stable Dropbox ID. Must have + * length of at least 40, have length of at most 40, and not be {@code + * null}. * @param name Details of a user's name. Must not be {@code null}. * @param email The user's email address. Do not rely on this without * checking the {@link Account#getEmailVerified} field. Even then, it's - * possible that the user has since lost access to their email. Must not - * be {@code null}. + * possible that the user has since lost access to their email. Note: + * email is not a unique or stable identifier for a Dropbox account. + * Users can change their email, and emails can be reused by different + * accounts. Apps should not use email as a key for account + * identification; use {@link Account#getAccountId} instead. Must not be + * {@code null}. * @param emailVerified Whether the user has verified their email address. * @param disabled Whether the user has been disabled. * @param locale The language that the user specified. Locale tags will be diff --git a/core/src/main/stone b/core/src/main/stone index 22a3058f8c..404afad5c5 160000 --- a/core/src/main/stone +++ b/core/src/main/stone @@ -1 +1 @@ -Subproject commit 22a3058f8c5594956fcded8d120700475c2ec9d7 +Subproject commit 404afad5c508a45ea9004c9d8c0cd4a56f0fbf22