File perl-Microsoft-AdCenter.spec of Package perl-Microsoft-AdCenter

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Microsoft-AdCenter.spec of Package perl-Microsoft-AdCenter

#
# spec file for package perl-Microsoft-AdCenter
#
# Copyright (c) 2019 SUSE LINUX GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via https://bugs.opensuse.org/
#

Name:           perl-Microsoft-AdCenter
Version:        8.11
Release:        0
%define cpan_name Microsoft-AdCenter
Summary:        An interface which abstracts Microsoft adCenter API
License:        Artistic-1.0
Group:          Development/Libraries/Perl
Url:            https://metacpan.org/release/%{cpan_name}
Source0:        https://cpan.metacpan.org/authors/id/X/XE/XERXES/%{cpan_name}-%{version}.tar.gz
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Class::Accessor::Chained)
BuildRequires:  perl(Crypt::SSLeay)
BuildRequires:  perl(DateTime::Format::ISO8601)
BuildRequires:  perl(DateTime::Format::W3CDTF)
BuildRequires:  perl(SOAP::Lite) >= 0.71
BuildRequires:  perl(Test::Class)
Requires:       perl(Class::Accessor::Chained)
Requires:       perl(Crypt::SSLeay)
Requires:       perl(DateTime::Format::ISO8601)
Requires:       perl(DateTime::Format::W3CDTF)
Requires:       perl(SOAP::Lite) >= 0.71
Requires:       perl(Test::Class)
%{perl_requires}

%description
Microsoft adCenter API allows you to manage your adCenter account in an
automated fashion rather than manually. The API is exposed as a standard
SOAP service that you can make calls to. This set of modules is designed to
make using the SOAP service easier than using SOAP::Lite (for example)
directly. There are 2 main types of modules available. The service modules
(AdministrationService, CampaignManagementService,
CustomerManagementService, etc.) are used to make the actual calls to each
of the SOAP services in the API. The other type of module provided are the
complex type modules, each of which represents one of the complex types
defined in one of the WSDLs of the SOAP service. Examples include Campaign,
AdGroup, Ad, Keyword, etc.

The calls you can make to the various services are documented on MSDN. See

http://msdn.microsoft.com/en-us/library/ee730327.aspx

Where the documentation indicates that a complex type must be passed in to
a particular service call, you must pass in the appropriate
Microsoft::AdCenter::ComplexType object. For example,
CampaignManagementService->AddCampaigns requires that an array of Campaigns
be passed in:

use Microsoft::AdCenter::V7::CampaignManagementService;
    use Microsoft::AdCenter::V7::CampaignManagementService::Campaign;

# Create the service client
    my $campaign_mgmt_service = Microsoft::AdCenter::V7::CampaignManagementService->new(
        ApplicationToken  => "your_application_token",
        CustomerAccountId => "your_customer_account_id",
        CustomerId        => "your_customer_id",
        DeveloperToken    => "your_developer_token",
        Password          => "your_password",
        UserName          => "your_user_name"
    );

# Create a Campaign object
    my $campaign = Microsoft::AdCenter::V7::CampaignManagementService::Campaign->new
        ->BudgetType("MonthlyBudgetDivideDailyAcrossMonth")
        ->ConversionTrackingEnabled("false")
        ->DaylightSaving("true")
        ->Description("the campaign description")
        ->MonthlyBudget(1000)
        ->Name("the campaign name")
        ->TimeZone("EasternTimeUSCanada")

# Call AddCampaigns
    my $response = $campaign_mgmt_service->AddCampaigns(
        AccountId => "",
        Campaigns => [$campaign]
    );

# Check the response
    my $campaign_ids = $response->CampaignIds;
    ...

Note that all simple types referenced in the WSDLs are automatically
handled for you - just pass in an appropriate string, and let
Microsoft::AdCenter do the rest.

When a method expects an array of objects / strings / numbers / etc., you
must pass an array reference.

If the SOAP call succeeded, you will receive a response object. See the
perldoc for the specific service client module for the return types.

If a SOAP Fault is encountered (whenever a call fails), the service client
will throw a Microsoft::AdCenter::SOAPFault object.

%prep
%setup -q -n %{cpan_name}-%{version}

%build
perl Makefile.PL INSTALLDIRS=vendor
make %{?_smp_mflags}

%check
make test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Changes README

%changelog

Places

File perl-Microsoft-AdCenter.spec of Package perl-Microsoft-AdCenter

Places