この記事は Mike Cloonan による Google Ads Developer Blog の記事 "Adding New Resource Types to ChangeStatus in Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。
![]()
現在、
新しいリソースタイプのサポートが追加されると、すべてのバージョンの API で新しい行を取得できるようになります。その際に、すでにリリースされているバージョンでは、
その行の新しいリソース名には、変更の種類を表す識別子が含まれます。最新の識別子のリストは、ステータス変更ガイドをご覧ください。これを調べる必要があるのは、
質問がある方は、サポートを受けることができるようにフォーラムに投稿してください。
change_statusレポートにいくつかの新しいリソースタイプを追加する作業を懸命に進めています。今後、shared_setや assetなどを改善する予定です。これらのタイプは今後のバージョンの Google Ads API で完全にサポートされますが、そのために現在行っているインフラストラクチャの変更作業によって、既存のバージョンにも多少の影響が発生します。新しいリソースタイプのサポートが追加されると、すべてのバージョンの API で新しい行を取得できるようになります。その際に、すでにリリースされているバージョンでは、
resource_typeが UNKNOWNとして返却されます。具体的には、これまで CAMPAIGNなどの既知の resource_typeが返されていた行で、UNKNOWNリソースタイプが返される場合があります。これが発生するのは、これまで CAMPAIGNの変更と報告されていた変更が、実際には CAMPAIGN_ASSETの変更だった場合などです。今後のバージョンの API は CAMPAIGN_ASSETリソースタイプを認識しますが、既存のバージョンは認識しないので、UNKNOWNを使うしかありません。この行には、新しい resource_nameも関連付けられ、アセットの ID が含まれるようになります。その行の新しいリソース名には、変更の種類を表す識別子が含まれます。最新の識別子のリストは、ステータス変更ガイドをご覧ください。これを調べる必要があるのは、
UNKNOWNリソースタイプが含まれる行だけです。これにより、今後の API バージョンでそのリソースタイプが完全にサポートされたときに返されるリソースタイプがわかります。change_status レポートには、新しいリソースタイプを複数追加する予定なので、さまざまな新しいリソースタイプに対して UNKNOWNタイプが出現する可能性があります。これが表示されるのは、今後のリリースによって change_statusレポートで新しいリソースタイプがサポートされるためなので、ご安心ください。質問がある方は、サポートを受けることができるようにフォーラムに投稿してください。