IssueTracker

Description

The published discovery document https://groupssettings.googleapis.com/$discovery/rest?version=v1 for the groupssettings v1 API has the following description for the whoCanJoin field of the Groups resource:

Permission to join group. Possible values are:

• ANYONE_CAN_JOIN: Anyone in the account domain can join. This includes accounts with multiple domains.
• ALL_IN_DOMAIN_CAN_JOIN: Any Internet user who is outside your domain can access your Google Groups service and view the list of groups in your Groups directory. Warning: Group owners can add external addresses, outside of the domain to their groups. They can also allow people outside your domain to join their groups. If you later disable this option, any external addresses already added to users' groups remain in those groups.
• INVITED_CAN_JOIN: Candidates for membership can be invited to join.
• CAN_REQUEST_TO_JOIN: Non members can request an invitation to join.

Note that the descriptions for ANYONE_CAN_JOIN and ALL_IN_DOMAIN_CAN_JOIN are swapped.

The reference documentation on developers.google.com (link) is correct, suggesting that the published discovery document just needs to be updated.

Impact

This is causing confusion for customers using client libraries. e.g. https://github.com/googleapis/google-api-ruby-client/issues/19535