An API key used for authenticating requests from your Apple app, e.g.
The key must begin with “A” and contain exactly 39 alphanumeric characters, used to identify your
app to Google servers.
The OAuth2 client ID for Apple applications used to authenticate Google users, for example
@“12345.apps.googleusercontent.com”, used for signing in with Google.
The App Group identifier to share data between the application and the application extensions.
The App Group must be configured in the application and on the Apple Developer Portal. Default
value nil.
Initializes a customized instance of FirebaseOptions from the file at the given plist file path.
This will read the file synchronously from disk.
For example:
Initializes a customized instance of FirebaseOptions with required fields. Use the mutable
properties to modify fields for configuring specific services. Note that it is not possible to
customize FirebaseOptions for Firebase Analytics which expects a static file named
GoogleServices-Info.plist - https://github.com/firebase/firebase-ios-sdk/issues/230.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-15 UTC."],[],[],null,["# FirebaseCore Framework Reference\n\nFIROptions\n==========\n\n\n @interface FIROptions : NSObject \u003cNSCopying\u003e\n\nThis class provides constant fields of Google APIs.\n- `\n ``\n ``\n `\n\n ### [+defaultOptions](#/c:objc(cs)FIROptions(cm)defaultOptions)\n\n `\n ` \n Returns the default options. The first time this is called it synchronously reads\n GoogleService-Info.plist from disk. \n\n #### Declaration\n\n Objective-C \n\n + (nullable FIROptions *)defaultOptions;\n\n- `\n ``\n ``\n `\n\n ### [APIKey](#/c:objc(cs)FIROptions(py)APIKey)\n\n `\n ` \n An API key used for authenticating requests from your Apple app, e.g.\n The key must begin with \"A\" and contain exactly 39 alphanumeric characters, used to identify your\n app to Google servers. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy, nullable) NSString *APIKey;\n\n- `\n ``\n ``\n `\n\n ### [bundleID](#/c:objc(cs)FIROptions(py)bundleID)\n\n `\n ` \n The bundle ID for the application. Defaults to `Bundle.main.bundleIdentifier` when not set\n manually or in a plist. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy) NSString *_Nonnull bundleID;\n\n- `\n ``\n ``\n `\n\n ### [clientID](#/c:objc(cs)FIROptions(py)clientID)\n\n `\n ` \n The OAuth2 client ID for Apple applications used to authenticate Google users, for example\n @\"12345.apps.googleusercontent.com\", used for signing in with Google. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy, nullable) NSString *clientID;\n\n- `\n ``\n ``\n `\n\n ### [GCMSenderID](#/c:objc(cs)FIROptions(py)GCMSenderID)\n\n `\n ` \n The Project Number from the Google Developer's console, for example @\"012345678901\", used to\n configure Firebase Cloud Messaging. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy) NS_SWIFT_NAME(gcmSenderID) NSString *GCMSenderID;\n\n- `\n ``\n ``\n `\n\n ### [projectID](#/c:objc(cs)FIROptions(py)projectID)\n\n `\n ` \n The Project ID from the Firebase console, for example @\"abc-xyz-123\". \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy, nullable) NSString *projectID;\n\n- `\n ``\n ``\n `\n\n ### [googleAppID](#/c:objc(cs)FIROptions(py)googleAppID)\n\n `\n ` \n The Google App ID that is used to uniquely identify an instance of an app. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy) NSString *_Nonnull googleAppID;\n\n- `\n ``\n ``\n `\n\n ### [databaseURL](#/c:objc(cs)FIROptions(py)databaseURL)\n\n `\n ` \n The database root URL, e.g. @\"\u003chttp://abc-xyz-123.firebaseio.com\u003e\". \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy, nullable) NSString *databaseURL;\n\n- `\n ``\n ``\n `\n\n ### [storageBucket](#/c:objc(cs)FIROptions(py)storageBucket)\n\n `\n ` \n The Google Cloud Storage bucket name, e.g. @\"abc-xyz-123.storage.firebase.com\". \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy, nullable) NSString *storageBucket;\n\n- `\n ``\n ``\n `\n\n ### [appGroupID](#/c:objc(cs)FIROptions(py)appGroupID)\n\n `\n ` \n The App Group identifier to share data between the application and the application extensions.\n The App Group must be configured in the application and on the Apple Developer Portal. Default\n value `nil`. \n\n #### Declaration\n\n Objective-C \n\n @property (nonatomic, copy, nullable) NSString *appGroupID;\n\n- `\n ``\n ``\n `\n\n ### [-initWithContentsOfFile:](#/c:objc(cs)FIROptions(im)initWithContentsOfFile:)\n\n `\n ` \n Initializes a customized instance of FirebaseOptions from the file at the given plist file path.\n This will read the file synchronously from disk.\n For example: \n\n if let path = Bundle.main.path(forResource:\"GoogleService-Info\", ofType:\"plist\") {\n let options = FirebaseOptions(contentsOfFile: path)\n }\n\n Note that it is not possible to customize `FirebaseOptions` for Firebase Analytics which expects\n a static file named `GoogleService-Info.plist` -\n \u003chttps://github.com/firebase/firebase-ios-sdk/issues/230\u003e.\n Returns `nil` if the plist file does not exist or is invalid. \n\n #### Declaration\n\n Objective-C \n\n - (nullable instancetype)initWithContentsOfFile:(nonnull NSString *)plistPath;\n\n- `\n ``\n ``\n `\n\n ### [-initWithGoogleAppID:GCMSenderID:](#/c:objc(cs)FIROptions(im)initWithGoogleAppID:GCMSenderID:)\n\n `\n ` \n Initializes a customized instance of `FirebaseOptions` with required fields. Use the mutable\n properties to modify fields for configuring specific services. Note that it is not possible to\n customize `FirebaseOptions` for Firebase Analytics which expects a static file named\n `GoogleServices-Info.plist` - \u003chttps://github.com/firebase/firebase-ios-sdk/issues/230\u003e. \n\n #### Declaration\n\n Objective-C \n\n - (nonnull instancetype)initWithGoogleAppID:(nonnull NSString *)googleAppID\n GCMSenderID:(nonnull NSString *)GCMSenderID;\n\n- `\n ``\n ``\n `\n\n ### [-init](#/c:objc(cs)FIROptions(im)init)\n\n `\n ` \n Unavailable \n Unavailable. Please use `init(contentsOfFile:)` or `init(googleAppID:gcmSenderID:)` instead. \n\n #### Declaration\n\n Objective-C \n\n - (nonnull instancetype)init;"]]