Apple Business data specification guidance for capturing URLs

URI

General

• MUST be an RFC 3986-compliant URI
• MUST include a scheme
  • https or http
• MUST be publicly accessible and not require login to view content
• Referenced resource MUST be officially recognized and accepted by the organization
• Referenced resource SHOULD be relevant in the context of the brand or location's associated country
• When type is IOS_APP, the url MUST be the location of the provider's application in the App Store
• MUST NOT be a redirection URL
• MUST NOT include a UTM parameter

Asset (Location)

• When the URI references a photo, it MUST link to either JPEG or PNG
• When the URI is intended to be used to download a resource, access to the resource SHOULD be ensured.
  • If response headers are not received within 9 seconds, the file download request is aborted
  • File size SHOULD NOT exceed 15 megabytes
• MUST NOT be embedded into text when the definition of the property does not not explicitly permit it

Brand

• MUST list at least one (1) URL
• MUST point to content belonging to the brand and not any related brand
• MUST NOT include a list of home pages belonging to the brand's associated locations

Used by:

Resource	Property
Brand	brandDetails.urls[].url
Location	locationDetails.urls[].url
Location	locationDetails.actionLinkDetails.quicklinks[].appStoreUrl
Location	locationDetails.actionLinkDetails.quicklinks[].quicklinkUrl
Location Asset	assetDetails.photos.{key}.url