001// Generated by delombok at Tue Dec 10 13:42:03 UTC 2024 002/* 003 * Copyright (c) 2010-2024 Mark Allen, Norbert Bartels. 004 * 005 * Permission is hereby granted, free of charge, to any person obtaining a copy 006 * of this software and associated documentation files (the "Software"), to deal 007 * in the Software without restriction, including without limitation the rights 008 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 009 * copies of the Software, and to permit persons to whom the Software is 010 * furnished to do so, subject to the following conditions: 011 * 012 * The above copyright notice and this permission notice shall be included in 013 * all copies or substantial portions of the Software. 014 * 015 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 016 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 017 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 018 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 019 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 020 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 021 * THE SOFTWARE. 022 */ 023package com.restfb.types.ads; 024 025import java.util.ArrayList; 026import java.util.Date; 027import java.util.List; 028import com.restfb.Facebook; 029import com.restfb.annotation.GraphAPI; 030import com.restfb.types.features.HasCreatedTime; 031 032/** 033 * Represents the <a href="https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group">Campaign</a> 034 * Marketing API type 035 */ 036public class Campaign extends NamedAdsObject implements HasCreatedTime { 037 /** 038 * ID of the ad account that owns this campaign 039 */ 040 @Facebook("account_id") 041 private String accountId; 042 /** 043 * Ad Labels associated with this campaign 044 */ 045 @Facebook("adlabels") 046 private List<AdLabel> adlabels; 047 /** 048 * Bid strategy for this campaign 049 */ 050 @Facebook("bid_strategy") 051 private String bidStrategy; 052 /** 053 * The Boosted Object this campaign has associated, if any 054 */ 055 @Facebook("boosted_object_id") 056 private String boostedObjectId; 057 /** 058 * Automated Brand Lift V2 studies for this ad set. 059 */ 060 @Facebook("brand_lift_studies") 061 private List<AdStudy> brandLiftStudies = new ArrayList<>(); 062 /** 063 * Whether to automatically rebalance budgets daily for all the adsets under this campaign. 064 */ 065 @Facebook("budget_rebalance_flag") 066 private Boolean budgetRebalanceFlag; 067 /** 068 * Remaining budget 069 */ 070 @Facebook("budget_remaining") 071 private String budgetRemaining; 072 /** 073 * Buying type, possible values are: 074 * <ul> 075 * <li>AUCTION: default</li> 076 * <li>RESERVED: for reach and frequency ads</li> 077 * </ul> 078 */ 079 @Facebook("buying_type") 080 private String buyingType; 081 /** 082 * If we can create a new automated brand lift study for the ad set. 083 */ 084 @Facebook("can_create_brand_lift_study") 085 private Boolean canCreateBrandLiftStudy; 086 /** 087 * Whether the campaign can set the spend cap 088 */ 089 @Facebook("can_use_spend_cap") 090 private Boolean canUseSpendCap; 091 /** 092 * If this status is PAUSED, all its active ad sets and ads will be paused and have an effective status 093 * CAMPAIGN_PAUSED. Prefer using 'status' instead of this. 094 * 095 * possible values: ACTIVE, PAUSED, DELETED, ARCHIVED 096 */ 097 @Facebook("configured_status") 098 private String configuredStatus; 099 /** 100 * Created Time 101 */ 102 @Facebook("created_time") 103 private Date createdTime; 104 /** 105 * The daily budget of the campaign 106 */ 107 @Facebook("daily_budget") 108 private String dailyBudget; 109 /** 110 * The effective status of this campaign. 111 * 112 * possible values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, 113 * CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED 114 */ 115 @Facebook("effective_status") 116 private String effectiveStatus; 117 /** 118 * Issues for this campaign that prevented it from deliverying. 119 */ 120 @Facebook("issues_info") 121 @GraphAPI(since = "3.2") 122 private List<AdCampaignIssuesInfo> issuesInfo = new ArrayList<>(); 123 /** 124 * Last budget toggling time 125 */ 126 @Facebook("last_budget_toggling_time") 127 private Date lastBudgetTogglingTime; 128 /** 129 * The lifetime budget of the campaign 130 */ 131 @Facebook("lifetime_budget") 132 private String lifetimeBudget; 133 /** 134 * Campaign's objective 135 */ 136 @Facebook 137 private String objective; 138 /** 139 * If there are recommendations for this campaign, this field includes them. 140 */ 141 @Facebook 142 private List<AdRecommendation> recommendations = new ArrayList<>(); 143 /** 144 * The source campaign that this campaign is copied from 145 */ 146 @Facebook("source_campaign") 147 private Campaign sourceCampaign; 148 /** 149 * The source campaign id that this campaign is copied from 150 */ 151 @Facebook("source_campaign_id") 152 private String sourceCampaignId; 153 /** 154 * The campaign's Special Ad Category. One of {@code HOUSING}, {@code EMPLOYMENT}, {@code CREDIT}, or {@code NONE}. 155 */ 156 @Deprecated 157 @GraphAPI(until = "7.0") 158 @Facebook("special_ad_category") 159 private String specialAdCategory; 160 @GraphAPI(since = "7.0") 161 @Facebook("special_ad_categories") 162 private List<String> specialAdCategories = new ArrayList<>(); 163 /** 164 * A spend cap for the campaign, such that it will not spend more than this cap. Expressed as integer value of the 165 * subunit in your currency. 166 */ 167 @Facebook("spend_cap") 168 private String spendCap; 169 /** 170 * Start Time 171 */ 172 @Facebook("start_time") 173 private Date startTime; 174 /** 175 * If this status is PAUSED, all its active ad sets and ads will be paused and have an effective status 176 * CAMPAIGN_PAUSED. The field returns the same value as 'configured_status', and is the suggested one to use. 177 */ 178 @Facebook 179 private String status; 180 /** 181 * Stop Time 182 */ 183 @Facebook("stop_time") 184 private Date stopTime; 185 /** 186 * Topline ID 187 */ 188 @Facebook("topline_id") 189 private String toplineId; 190 /** 191 * Updated Time 192 */ 193 @Facebook("updated_time") 194 private Date updatedTime; 195 196 /** 197 * @return ID of the ad account that owns this campaign 198 */ 199 @java.lang.SuppressWarnings("all") 200 public String getAccountId() { 201 return this.accountId; 202 } 203 204 /** 205 * ID of the ad account that owns this campaign 206 */ 207 @java.lang.SuppressWarnings("all") 208 public void setAccountId(final String accountId) { 209 this.accountId = accountId; 210 } 211 212 /** 213 * @return Ad Labels associated with this campaign 214 */ 215 @java.lang.SuppressWarnings("all") 216 public List<AdLabel> getAdlabels() { 217 return this.adlabels; 218 } 219 220 /** 221 * Ad Labels associated with this campaign 222 */ 223 @java.lang.SuppressWarnings("all") 224 public void setAdlabels(final List<AdLabel> adlabels) { 225 this.adlabels = adlabels; 226 } 227 228 /** 229 * Bid strategy for this campaign 230 */ 231 @java.lang.SuppressWarnings("all") 232 public String getBidStrategy() { 233 return this.bidStrategy; 234 } 235 236 /** 237 * Bid strategy for this campaign 238 */ 239 @java.lang.SuppressWarnings("all") 240 public void setBidStrategy(final String bidStrategy) { 241 this.bidStrategy = bidStrategy; 242 } 243 244 /** 245 * The Boosted Object this campaign has associated, if any 246 */ 247 @java.lang.SuppressWarnings("all") 248 public String getBoostedObjectId() { 249 return this.boostedObjectId; 250 } 251 252 /** 253 * The Boosted Object this campaign has associated, if any 254 */ 255 @java.lang.SuppressWarnings("all") 256 public void setBoostedObjectId(final String boostedObjectId) { 257 this.boostedObjectId = boostedObjectId; 258 } 259 260 /** 261 * Automated Brand Lift V2 studies for this ad set. 262 */ 263 @java.lang.SuppressWarnings("all") 264 public List<AdStudy> getBrandLiftStudies() { 265 return this.brandLiftStudies; 266 } 267 268 /** 269 * Automated Brand Lift V2 studies for this ad set. 270 */ 271 @java.lang.SuppressWarnings("all") 272 public void setBrandLiftStudies(final List<AdStudy> brandLiftStudies) { 273 this.brandLiftStudies = brandLiftStudies; 274 } 275 276 /** 277 * Whether to automatically rebalance budgets daily for all the adsets under this campaign. 278 */ 279 @java.lang.SuppressWarnings("all") 280 public Boolean getBudgetRebalanceFlag() { 281 return this.budgetRebalanceFlag; 282 } 283 284 /** 285 * Whether to automatically rebalance budgets daily for all the adsets under this campaign. 286 */ 287 @java.lang.SuppressWarnings("all") 288 public void setBudgetRebalanceFlag(final Boolean budgetRebalanceFlag) { 289 this.budgetRebalanceFlag = budgetRebalanceFlag; 290 } 291 292 /** 293 * Remaining budget 294 */ 295 @java.lang.SuppressWarnings("all") 296 public String getBudgetRemaining() { 297 return this.budgetRemaining; 298 } 299 300 /** 301 * Remaining budget 302 */ 303 @java.lang.SuppressWarnings("all") 304 public void setBudgetRemaining(final String budgetRemaining) { 305 this.budgetRemaining = budgetRemaining; 306 } 307 308 /** 309 * @return Buying type 310 */ 311 @java.lang.SuppressWarnings("all") 312 public String getBuyingType() { 313 return this.buyingType; 314 } 315 316 /** 317 * Buying type, possible values are: 318 * <ul> 319 * <li>AUCTION: default</li> 320 * <li>RESERVED: for reach and frequency ads</li> 321 * </ul> 322 */ 323 @java.lang.SuppressWarnings("all") 324 public void setBuyingType(final String buyingType) { 325 this.buyingType = buyingType; 326 } 327 328 /** 329 * If we can create a new automated brand lift study for the ad set. 330 */ 331 @java.lang.SuppressWarnings("all") 332 public Boolean getCanCreateBrandLiftStudy() { 333 return this.canCreateBrandLiftStudy; 334 } 335 336 /** 337 * If we can create a new automated brand lift study for the ad set. 338 */ 339 @java.lang.SuppressWarnings("all") 340 public void setCanCreateBrandLiftStudy(final Boolean canCreateBrandLiftStudy) { 341 this.canCreateBrandLiftStudy = canCreateBrandLiftStudy; 342 } 343 344 /** 345 * @return Whether the campaign can set the spend cap 346 */ 347 @java.lang.SuppressWarnings("all") 348 public Boolean getCanUseSpendCap() { 349 return this.canUseSpendCap; 350 } 351 352 /** 353 * Whether the campaign can set the spend cap 354 */ 355 @java.lang.SuppressWarnings("all") 356 public void setCanUseSpendCap(final Boolean canUseSpendCap) { 357 this.canUseSpendCap = canUseSpendCap; 358 } 359 360 /** 361 * @return the configured status 362 */ 363 @java.lang.SuppressWarnings("all") 364 public String getConfiguredStatus() { 365 return this.configuredStatus; 366 } 367 368 /** 369 * If this status is PAUSED, all its active ad sets and ads will be paused and have an effective status 370 * CAMPAIGN_PAUSED. Prefer using 'status' instead of this. 371 * 372 * possible values: ACTIVE, PAUSED, DELETED, ARCHIVED 373 */ 374 @java.lang.SuppressWarnings("all") 375 public void setConfiguredStatus(final String configuredStatus) { 376 this.configuredStatus = configuredStatus; 377 } 378 379 /** 380 * @return Created Time 381 */ 382 @Override 383 @java.lang.SuppressWarnings("all") 384 public Date getCreatedTime() { 385 return this.createdTime; 386 } 387 388 /** 389 * Created Time 390 */ 391 @java.lang.SuppressWarnings("all") 392 public void setCreatedTime(final Date createdTime) { 393 this.createdTime = createdTime; 394 } 395 396 /** 397 * The daily budget of the campaign 398 */ 399 @java.lang.SuppressWarnings("all") 400 public String getDailyBudget() { 401 return this.dailyBudget; 402 } 403 404 /** 405 * The daily budget of the campaign 406 */ 407 @java.lang.SuppressWarnings("all") 408 public void setDailyBudget(final String dailyBudget) { 409 this.dailyBudget = dailyBudget; 410 } 411 412 /** 413 * @return The effective status of this campaign 414 */ 415 @java.lang.SuppressWarnings("all") 416 public String getEffectiveStatus() { 417 return this.effectiveStatus; 418 } 419 420 /** 421 * The effective status of this campaign. 422 * 423 * possible values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, 424 * CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED 425 */ 426 @java.lang.SuppressWarnings("all") 427 public void setEffectiveStatus(final String effectiveStatus) { 428 this.effectiveStatus = effectiveStatus; 429 } 430 431 /** 432 * @return List of issues for this campaign that prevented it from deliverying. 433 */ 434 @GraphAPI(since = "3.2") 435 @java.lang.SuppressWarnings("all") 436 public List<AdCampaignIssuesInfo> getIssuesInfo() { 437 return this.issuesInfo; 438 } 439 440 /** 441 * Issues for this campaign that prevented it from deliverying. 442 */ 443 @java.lang.SuppressWarnings("all") 444 public void setIssuesInfo(final List<AdCampaignIssuesInfo> issuesInfo) { 445 this.issuesInfo = issuesInfo; 446 } 447 448 /** 449 * Last budget toggling time 450 */ 451 @java.lang.SuppressWarnings("all") 452 public Date getLastBudgetTogglingTime() { 453 return this.lastBudgetTogglingTime; 454 } 455 456 /** 457 * Last budget toggling time 458 */ 459 @java.lang.SuppressWarnings("all") 460 public void setLastBudgetTogglingTime(final Date lastBudgetTogglingTime) { 461 this.lastBudgetTogglingTime = lastBudgetTogglingTime; 462 } 463 464 /** 465 * The lifetime budget of the campaign 466 */ 467 @java.lang.SuppressWarnings("all") 468 public String getLifetimeBudget() { 469 return this.lifetimeBudget; 470 } 471 472 /** 473 * The lifetime budget of the campaign 474 */ 475 @java.lang.SuppressWarnings("all") 476 public void setLifetimeBudget(final String lifetimeBudget) { 477 this.lifetimeBudget = lifetimeBudget; 478 } 479 480 /** 481 * @return Campaign's objective 482 */ 483 @java.lang.SuppressWarnings("all") 484 public String getObjective() { 485 return this.objective; 486 } 487 488 /** 489 * Campaign's objective 490 */ 491 @java.lang.SuppressWarnings("all") 492 public void setObjective(final String objective) { 493 this.objective = objective; 494 } 495 496 /** 497 * @return If there are recommendations for this campaign, this field includes them. 498 */ 499 @java.lang.SuppressWarnings("all") 500 public List<AdRecommendation> getRecommendations() { 501 return this.recommendations; 502 } 503 504 /** 505 * If there are recommendations for this campaign, this field includes them. 506 */ 507 @java.lang.SuppressWarnings("all") 508 public void setRecommendations(final List<AdRecommendation> recommendations) { 509 this.recommendations = recommendations; 510 } 511 512 /** 513 * The source campaign that this campaign is copied from 514 */ 515 @java.lang.SuppressWarnings("all") 516 public Campaign getSourceCampaign() { 517 return this.sourceCampaign; 518 } 519 520 /** 521 * The source campaign that this campaign is copied from 522 */ 523 @java.lang.SuppressWarnings("all") 524 public void setSourceCampaign(final Campaign sourceCampaign) { 525 this.sourceCampaign = sourceCampaign; 526 } 527 528 /** 529 * The source campaign id that this campaign is copied from 530 */ 531 @java.lang.SuppressWarnings("all") 532 public String getSourceCampaignId() { 533 return this.sourceCampaignId; 534 } 535 536 /** 537 * The source campaign id that this campaign is copied from 538 */ 539 @java.lang.SuppressWarnings("all") 540 public void setSourceCampaignId(final String sourceCampaignId) { 541 this.sourceCampaignId = sourceCampaignId; 542 } 543 544 /** 545 * The campaign's Special Ad Category. One of {@code HOUSING}, {@code EMPLOYMENT}, {@code CREDIT}, or {@code NONE}. 546 */ 547 @java.lang.Deprecated 548 @java.lang.SuppressWarnings("all") 549 public String getSpecialAdCategory() { 550 return this.specialAdCategory; 551 } 552 553 /** 554 * The campaign's Special Ad Category. One of {@code HOUSING}, {@code EMPLOYMENT}, {@code CREDIT}, or {@code NONE}. 555 */ 556 @java.lang.Deprecated 557 @java.lang.SuppressWarnings("all") 558 public void setSpecialAdCategory(final String specialAdCategory) { 559 this.specialAdCategory = specialAdCategory; 560 } 561 562 @java.lang.SuppressWarnings("all") 563 public List<String> getSpecialAdCategories() { 564 return this.specialAdCategories; 565 } 566 567 @java.lang.SuppressWarnings("all") 568 public void setSpecialAdCategories(final List<String> specialAdCategories) { 569 this.specialAdCategories = specialAdCategories; 570 } 571 572 /** 573 * @return A spend cap for the campaign, such that it will not spend more than this cap. 574 */ 575 @java.lang.SuppressWarnings("all") 576 public String getSpendCap() { 577 return this.spendCap; 578 } 579 580 /** 581 * A spend cap for the campaign, such that it will not spend more than this cap. Expressed as integer value of the 582 * subunit in your currency. 583 */ 584 @java.lang.SuppressWarnings("all") 585 public void setSpendCap(final String spendCap) { 586 this.spendCap = spendCap; 587 } 588 589 /** 590 * @return Start Time 591 */ 592 @java.lang.SuppressWarnings("all") 593 public Date getStartTime() { 594 return this.startTime; 595 } 596 597 /** 598 * Start Time 599 */ 600 @java.lang.SuppressWarnings("all") 601 public void setStartTime(final Date startTime) { 602 this.startTime = startTime; 603 } 604 605 /** 606 * @return the status 607 */ 608 @java.lang.SuppressWarnings("all") 609 public String getStatus() { 610 return this.status; 611 } 612 613 /** 614 * If this status is PAUSED, all its active ad sets and ads will be paused and have an effective status 615 * CAMPAIGN_PAUSED. The field returns the same value as 'configured_status', and is the suggested one to use. 616 */ 617 @java.lang.SuppressWarnings("all") 618 public void setStatus(final String status) { 619 this.status = status; 620 } 621 622 /** 623 * @return Stop Time 624 */ 625 @java.lang.SuppressWarnings("all") 626 public Date getStopTime() { 627 return this.stopTime; 628 } 629 630 /** 631 * Stop Time 632 */ 633 @java.lang.SuppressWarnings("all") 634 public void setStopTime(final Date stopTime) { 635 this.stopTime = stopTime; 636 } 637 638 /** 639 * Topline ID 640 */ 641 @java.lang.SuppressWarnings("all") 642 public String getToplineId() { 643 return this.toplineId; 644 } 645 646 /** 647 * Topline ID 648 */ 649 @java.lang.SuppressWarnings("all") 650 public void setToplineId(final String toplineId) { 651 this.toplineId = toplineId; 652 } 653 654 /** 655 * @return Updated Time 656 */ 657 @java.lang.SuppressWarnings("all") 658 public Date getUpdatedTime() { 659 return this.updatedTime; 660 } 661 662 /** 663 * Updated Time 664 */ 665 @java.lang.SuppressWarnings("all") 666 public void setUpdatedTime(final Date updatedTime) { 667 this.updatedTime = updatedTime; 668 } 669}