Hi, Thanks for the detailed question, and you bring up a good point. In general the status field of an entity is a type of user input, the desired state of the entity. There are other types of input too, such as start and end date. The servingStatus field is different though, as it is an output from the system of how the various inputs affect serving. It's a read only field that is subject to change based on a variety of reasons.
That said, I don't think you should use the servingStatus to influence which campaigns you pause. If you don't want a campaign to serve ads you should set the status to PAUSED, regardless of the servingStatus. This may result in a few cases where you pause a campaign that under current conditions wasn't serving ads anyway, but the status field should represent your intent for the campaign, and the servingStatus field should be used merely for feedback about how the system is handling the campaign. I hope this helps, and I'll work with the documentation team to get more of this information into the online documentation. Best, - Eric Koleda, AdWords API Team On Dec 14, 2:39 pm, "j.e.frank" <j.e.fr...@gmail.com> wrote: > I'm in the process of upgrading some code from v13 to v2009. I'm > trying to get a handle on the meaning of a Campaign's "status" and its > "serving status". Is there an explanation of these fields anywhere, > other than the list of the enumerated values for each? My sense is > that "status" refers to actions taken by users to manage the campaign > (through the UI or API), and that "serving status" is really only > relevant when the status is ACTIVE. But it would be nice to see it > documented. > > I'm trying to write a method to pause all campaigns associated with an > account, and return the number of affected campaigns. I want to pass > in to the mutate operation only those campaigns that have a chance of > running in the first place. To do this, I am checking the status and > serving status. Based on the possibilities for each, it seems that a > campaign that has reached its end date would be ACTIVE and ENDED > respectively, and thus I would not need to pause it. But if a > campaign were ACTIVE and any of PENDING, NONE, or SUSPENDED, then it > is conceivable that the ads could start running at some point without > direct user intervention, and so I would want to pause it. I am also > assuming that a campaign with a status of anything other than ACTIVE > has no chance of running. -- You received this message because you are subscribed to the Google Groups "AdWords API Forum" group. To post to this group, send email to adwords-...@googlegroups.com. To unsubscribe from this group, send email to adwords-api+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/adwords-api?hl=en.
