An operation that retrieves the IDs of all discoverable users that are also in the user’s address book.
- iOS 8.0–10.0Deprecated
- macOS 10.10–10.12Deprecated
- Mac Catalyst 13.0–13.0Deprecated
- watchOS 3.0–3.0Deprecated
The search of the user’s address book does not return any personal data about the user’s contacts. The search returns only the IDs of the corresponding user records, which contain only data that your app puts there. CloudKit uses the address book information to identify users of the app that the current user knows. Because the system accesses the address book instead of your app, the system does not display a prompt to the user when that access occurs.
Users of an app must opt in to discoverability before their user records can be accessed. To opt in for a user, your app must call the
request method of your container object and request the
user permission. Calling that method prompts the user to grant or deny the permission.
If you assign a completion block to the
completion property of the operation object, the completion block is called after the operation executes and returns its results to you. You can use a completion block to perform housekeeping chores related to the operation, but do not use it to process the results of the operation itself. Any completion block you specify should be prepared to handle the failure of the operation to complete its task, whether due to an error or an explicit cancellation.