googleapis / googleapis/google-api-java-client-services

Android Management API Deprecations

未关闭
#22,611 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
priority: p2 type: feature request
主要语言
Java
星标
725
派生
394
平均合并
42 分钟
30 天内合并 PR
257

描述

While having a look at the [Android Management API Client](https://github.com/googleapis/google-api-java-client-services/tree/main/clients/google-api-services-androidmanagement) in comparison with the reference documentation, I noticed that there are some fields and methods marked as deprecated within the reference but not within the Java client library.
E.g.: "statusBarDisabled" of [Policies](https://developers.google.com/android/management/reference/rest/v1/enterprises.policies).

As developer I'd love to notice deprecated API fields inside the related client code, so I can handle them directly when using them.

My suggestion would be to include a proper `@Deprecated` annotation in combination with a good JavaDoc which leads me to the correct place. This would increase the visibility of deprecation within the regular development process.
E.g:
```java
/**
* Password requirements. The field password_requirements.require_password_unlock must not be set.
*
* @deprecated Use passwordPolicies instead.
*
* Note: Complexity-based values of PasswordQuality, that is,
* COMPLEXITY_LOW, COMPLEXITY_MEDIUM, and COMPLEXITY_HIGH, cannot be used here.
* unified_lock_settings cannot be used here.
* @param passwordRequirements passwordRequirements or {@code null} for none
*/
@Deprecated
public Policy setPasswordRequirements(PasswordRequirements passwordRequirements) {
this.passwordRequirements = passwordRequirements;
return this;
}
```

I'm willing to contribute with a PR containing the annotations of deprecations of the Android Management API together with proper documentation about alternatives as described within the API reference documentation. Just add the "Accepting Contributions" label and I'll set up a PR for it.

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。