Merge "identity: Add clarifications to newly added API." am: ad3097312c am: e502cbe5db

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/2007310

Change-Id: I1c1e67459b5fc44bbac09e9fa0e71cbfe1f0b604