AI-generated Key Takeaways
-
Represents a Bulk Upload of an existing file from sources like Blob, Google Sheet, or Drive File.
-
Offers methods to apply changes directly or preview them before execution.
-
Can be used for Campaign Management entity changes (default) or reporting offline conversions.
-
Allows setting a custom file name for the uploaded file.
Methods:
| Member | Type | Description |
|---|---|---|
| apply() | void |
Uploads the file and applies the changes. |
| forCampaignManagement() | AdsApp.FileUpload |
Specifies that this upload is used for Campaign Management entity changes. |
| forOfflineConversions() | AdsApp.FileUpload |
Specifies that this upload is used for reporting offline conversions. |
| preview() | void |
Uploads the file and previews the changes. |
| setFileName(fileName) | AdsApp.FileUpload |
Sets the file name of the uploaded file. |
apply()
Uploads the file and applies the changes.
Returns nothing.
forCampaignManagement()
Specifies that this upload is used for Campaign Management entity changes.
This is the default option, so this method doesn't need to be called except to override a previous call to FileUpload.forOfflineConversions().
Return values:
| Type | Description |
|---|---|
AdsApp.FileUpload |
The same upload specified to change Campaign Management entities. |
forOfflineConversions()
Specifies that this upload is used for reporting offline conversions.
By default, uploads are used for Campaign Management entity changes, so it's necessary to call FileUpload.forOfflineConversions() to make offline conversion uploads work correctly.
Return values:
| Type | Description |
|---|---|
AdsApp.FileUpload |
The same upload specified to report offline conversions. |
preview()
Uploads the file and previews the changes. Returns nothing.
setFileName(fileName)
Sets the file name of the uploaded file. Arguments:
| Name | Type | Description |
|---|---|---|
| fileName | String |
The file name of the uploaded file. |
Return values:
| Type | Description |
|---|---|
AdsApp.FileUpload |
The same upload with the file name applied. |